{"id":13501622,"url":"https://github.com/stav121/i3wm-themer","last_synced_at":"2025-03-29T09:31:08.480Z","repository":{"id":37538967,"uuid":"87830446","full_name":"stav121/i3wm-themer","owner":"stav121","description":" 🎨 Theme collection manager for i3-wm","archived":false,"fork":false,"pushed_at":"2024-10-31T08:58:15.000Z","size":74325,"stargazers_count":2229,"open_issues_count":20,"forks_count":245,"subscribers_count":43,"default_branch":"main","last_synced_at":"2024-10-31T09:32:01.380Z","etag":null,"topics":["i3-gaps","i3wm","linux","polybar","unix"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stav121.png","metadata":{"files":{"readme":"README.md","changelog":"change.sh","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["unix121"]}},"created_at":"2017-04-10T16:00:05.000Z","updated_at":"2024-10-31T08:58:20.000Z","dependencies_parsed_at":"2024-10-31T09:36:55.671Z","dependency_job_id":null,"html_url":"https://github.com/stav121/i3wm-themer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stav121%2Fi3wm-themer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stav121%2Fi3wm-themer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stav121%2Fi3wm-themer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stav121%2Fi3wm-themer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stav121","download_url":"https://codeload.github.com/stav121/i3wm-themer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246167090,"owners_count":20734379,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["i3-gaps","i3wm","linux","polybar","unix"],"created_at":"2024-07-31T22:01:44.086Z","updated_at":"2025-03-29T09:31:03.494Z","avatar_url":"https://github.com/stav121.png","language":"Python","funding_links":["https://github.com/sponsors/unix121"],"categories":["Python"],"sub_categories":[],"readme":"\u003ch1\u003ei3wm-themer\u003c/h1\u003e \n\n![](https://img.shields.io/github/repo-size/stav121/i3wm-themer)\n![](https://img.shields.io/circleci/build/github/stav121/i3wm-themer/main)\n![](https://img.shields.io/codacy/grade/79aa404309114b25bdc87f00107a0b94/main)\n![](https://img.shields.io/github/last-commit/unix121/i3wm-themer/main)\n![](https://img.shields.io/github/license/unix121/i3wm-themer)\n\u003cul\u003e\nPersonal collection of themes and scripts for \u003ca href=\"https://www.i3wm.org\"\u003ei3wm\u003c/a\u003e.\n\n![](workflow/workflow.gif?raw=true)\n\u003c/ul\u003e\n\n\u003ch1\u003eWhy?\u003c/h1\u003e\n\u003cul\u003e\n\u003cli\u003eYou like CLI tools too much\u003c/li\u003e\n\u003cli\u003eYou like simple and minimalistic desktop themes\u003c/li\u003e\n\u003cli\u003eYou always wanted to use i3wm but can't figure it out on your own\u003c/li\u003e\n\u003cli\u003eYou want to change themes on the go\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://www.i3wm.org\"\u003ei3wm\u003c/a\u003e is awesome\u003c/li\u003e\n\u003c/ul\u003e\n\n\u003ch1\u003eWhat you will need\u003c/h1\u003e\n\u003cul\u003e\n\u003cli\u003ePython 3\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://github.com/Airblader/i3\"\u003ei3-gaps\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://github.com/jaagr/polybar\"\u003ePolybar\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://github.com/DaveDavenport/rofi\"\u003eRofi\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://fontawesome.com\"\u003eFont-Awesome-5\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://aur.archlinux.org/packages/nitrogen-git/\"\u003eNitrogen\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://aur.archlinux.org/packages/nerd-fonts-complete/\"\u003enerd-fonts-complete\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://github.com/adobe-fonts/source-code-pro\"\u003eAdobe Source Code Pro font\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://wiki.archlinux.org/index.php/Rxvt-unicode\"\u003erxvt-unicode\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://archlinux.org/packages/extra/x86_64/alsa-utils\"\u003ealsa-utils\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://archlinux.org/packages/community/x86_64/mate-power-manager\"\u003emate-power-manager\u003c/a\u003e\u003c/li\u003e\n\u003c/ul\u003e\n\n\u003ch2\u003eUsing the script\u003c/h2\u003e\n\u003cul\u003e\nClone this repository and install the requirements for the script. For Debian users, check the \"Debian\" section below.\n\n```bash\ngit clone --depth=1 https://github.com/unix121/i3wm-themer\ncd i3wm-themer/\npython3 -m venv myenv\nsource myenv/bin/activate\npython3 -m pip install -r requirements.txt\n```\n\nInstall all the requirements from the 'What you will need' section.\nEither manually or use one of the scripts created for some distros:\n\n```bash\n# For Arch, ArchLabs or Manjaro Linux\n./install_arch.sh\n\n# For Debian\n./install_debian.sh\n\n# For Ubuntu\n./install_ubuntu.sh\n```\n\nIf you are not on one of the above, install them using your Package manager.\n\nMake sure you have the requirements mentioned earlier installed.\nEdit the \u003ca href=\"defaults/config.yaml\"\u003econfig.yaml\u003c/a\u003e file and add your full path of i3wm config, polybar config and .Xresources\nfiles. In the end it should look something like this:\n\n```dotfile\ni3-config: /home/[USER]/.i3/config\npolybar-config: /home/[USER]/.config/polybar/config\nxresources: /home/[USER]/.Xresources\n```\n\nWhere `[USER]` is your `$USER`.\n\nCopy the script in the \u003ca href=\"scripts/\"\u003escripts\u003c/a\u003e folder to your polybar directory:\n\n```bash\ncp -r scripts/* /home/$USER/.config/polybar/\n```\n\nBackup your files:\n\n```bash\nmkdir ~/Backups\npython3 i3wm-themer.py --config config.yaml --backup /home/[USER]/Backups\n```\n\nThis step will copy the files that you set in the `config.yaml` for safekeeping in case things go\nwrong.\n\nInstall the `config files` located in the \u003ca href=\"defaults\"\u003edefaults/\u003c/a\u003e directory (not 100% required but\nI suggest you do so just to be sure).\n\n```bash\npython3 i3wm-themer.py --config config.yaml --install defaults/\n```\n\nIn case you get lost `$mod+Return` will open a new terminal, `$mode+d` will launch Rofi. (For the\nrest of the shortcuts just take a look on the config file for i3, and change them to your needs.)\n\nNow you are basically ready to go. Pick a theme you like from the collection and load it:\n\n```bash\npython3 i3wm-themer.py --config config.yaml --load themes/[theme_id].json\n```\n\n(Where [theme_id] is the name of the theme you want to try!)\n\nTADA!!!\n\nNow every time you want to change a theme you can just run the command above with the theme you like\nand apply it instantly.\n\nYou can always use the `--help` on the script to check the given options.\n\u003c/ul\u003e\n\n\u003ch2\u003eDisclaimer\u003c/h2\u003e\n\u003cul\u003e\nI am not responsible for any harm done to your PC by anything in the repository. Use everything with\ncaution!\n\u003c/ul\u003e\n\n\u003ch2\u003eAvailable Themes\u003c/h2\u003e\n\u003cul\u003e\nJust take a look at the \u003ca href=\"themes/\"\u003eTheme collection\u003c/a\u003e and pick the ones you like.\n\n![](workflow/themepreview.png?raw=true)\n\n\u003c/ul\u003e\n\n\u003ch2\u003eAuthor\u003c/h2\u003e\n\u003cul\u003e\n\u003ca href=\"https://github.com/stav121\"\u003eStavros Grigoriou (stav121)\u003c/a\u003e\n\u003c/ul\u003e\n\n\u003ch2\u003eCredits\u003c/h2\u003e\n\u003cul\u003e\nThis whole project wouldn't be possible without the creators of all those awesome tools:\ni3wm, i3-gaps, polybar and everyone who worked on those projects.\n\u003c/ul\u003e\n\n\u003ch2\u003eAdvice for Debian and Fedora users\u003c/h2\u003e\n\nSince this project is focused on Arch-based distros it may behave unexpectedly in other distributions. For that matter we have a fork that is exclusively focused on Debian and Fedora with minor changes. Feel free to check it out!\n\n\u003ca href=\"https://github.com/cizordj/i3-themer\"\u003ei3 themer for Debian\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstav121%2Fi3wm-themer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstav121%2Fi3wm-themer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstav121%2Fi3wm-themer/lists"}