Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stav121/i3wm-themer
🎨 Theme collection manager for i3-wm
https://github.com/stav121/i3wm-themer
i3-gaps i3wm linux polybar unix
Last synced: 4 days ago
JSON representation
🎨 Theme collection manager for i3-wm
- Host: GitHub
- URL: https://github.com/stav121/i3wm-themer
- Owner: stav121
- License: mit
- Created: 2017-04-10T16:00:05.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2024-10-31T08:58:15.000Z (5 days ago)
- Last Synced: 2024-10-31T09:32:01.380Z (5 days ago)
- Topics: i3-gaps, i3wm, linux, polybar, unix
- Language: Python
- Homepage:
- Size: 70.9 MB
- Stars: 2,229
- Watchers: 43
- Forks: 245
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Changelog: change.sh
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome - stav121/i3wm-themer - 🎨 Theme collection manager for i3-wm (Python)
- awesome-github-repos - stav121/i3wm-themer - 🎨 Theme collection manager for i3-wm (Python)
README
i3wm-themer
Personal collection of themes and scripts for i3wm.
Why?
- You like CLI tools too much
- You like simple and minimalistic desktop themes
- You always wanted to use i3wm but can't figure it out on your own
- You want to change themes on the go
-
i3wm is awesome
What you will need
- Python 3
- i3-gaps
- Polybar
- Rofi
- Font-Awesome-5
- Nitrogen
- nerd-fonts-complete
- Adobe Source Code Pro font
- rxvt-unicode
- alsa-utils
- mate-power-manager
Using the script
Clone this repository and install the requirements for the script. For Debian users, check the "Debian" section below.
```bash
git clone --depth=1 https://github.com/unix121/i3wm-themer
cd i3wm-themer/
python3 -m venv myenv
source myenv/bin/activate
python3 -m pip install -r requirements.txt
```
Install all the requirements from the 'What you will need' section.
Either manually or use one of the scripts created for some distros:
```bash
# For Arch, ArchLabs or Manjaro Linux
./install_arch.sh
# For Debian
./install_debian.sh
# For Ubuntu
./install_ubuntu.sh
```
If you are not on one of the above, install them using your Package manager.
Make sure you have the requirements mentioned earlier installed.
Edit the config.yaml file and add your full path of i3wm config, polybar config and .Xresources
files. In the end it should look something like this:
```dotfile
i3-config: /home/[USER]/.i3/config
polybar-config: /home/[USER]/.config/polybar/config
xresources: /home/[USER]/.Xresources
```
Where `[USER]` is your `$USER`.
Copy the script in the scripts folder to your polybar directory:
```bash
cp -r scripts/* /home/$USER/.config/polybar/
```
Backup your files:
```bash
mkdir ~/Backups
python3 i3wm-themer.py --config config.yaml --backup /home/[USER]/Backups
```
This step will copy the files that you set in the `config.yaml` for safekeeping in case things go
wrong.
Install the `config files` located in the defaults/ directory (not 100% required but
I suggest you do so just to be sure).
```bash
python3 i3wm-themer.py --config config.yaml --install defaults/
```
In case you get lost `$mod+Return` will open a new terminal, `$mode+d` will launch Rofi. (For the
rest of the shortcuts just take a look on the config file for i3, and change them to your needs.)
Now you are basically ready to go. Pick a theme you like from the collection and load it:
```bash
python3 i3wm-themer.py --config config.yaml --load themes/[theme_id].json
```
(Where [theme_id] is the name of the theme you want to try!)
TADA!!!
Now every time you want to change a theme you can just run the command above with the theme you like
and apply it instantly.
You can always use the `--help` on the script to check the given options.
Disclaimer
I am not responsible for any harm done to your PC by anything in the repository. Use everything with
caution!
Available Themes
Just take a look at the Theme collection and pick the ones you like.
Author
Credits
This whole project wouldn't be possible without the creators of all those awesome tools:
i3wm, i3-gaps, polybar and everyone who worked on those projects.
Advice for Debian and Fedora users
Since 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!