linux-themer

A tool to customize the linux desktop environment

linux-themer
- About
  - Why themer?
  - Motivation
- Getting started
  - Install
  - Uninstall
- Usage
  - Examples
- Contributing
- License
- Contact

About

This is a lightweight wrapper of the gsettings utility to quickly tweak linux desktop environment theme settings (e.g., icon themes).

Why themer?

No need to memorize long path and key names
Quick access to common desktop environment settings
Auto-detection of running desktop environment

Motivation

Are you always changing your desktop's appearance based on your mood, experimenting with various designs, or a random need for something different? I created this tool to quickly change some of the more common desktop environment theme settings from the command line. For example, changing themes based on the time of day or quickly toggle between light and dark themes should be easy and intuitive. However, memorizing long gsettings schemas and keys is bothersome. So, themer was created to be a wrapper to easily tweak theme settings without the long path and key names.

A table of gsetting commands and their equivalent in themer are shown below.

Theme	`gsetting` key schema	`gsetting` key	`themer` key
Icons	`desktop.interface`	`icon-theme`	`icons`
Controls	`desktop.interface`	`gtk-theme`	`controls`
Window Borders	`desktop.wm.preferences`	`theme`	`windows`
Desktop	`theme`	`name`	`desktop`
Mouse pointer	`desktop.interface`	`cursor-theme`	`cursor`

See the Usage and Examples on how to use.

Getting started

Install

git clone https://github.com/trevor-moon/linux-themer.git
cd linux-themer
sudo make install

Uninstall

sudo make uninstall

Usage

Change desktop environment themes

Usage:
  themer.sh COMMAND

Commands:
  -h, --help          Show this information and exit
  -v, --version       Show version information and exit
  --get <theme>       Get the theme value
  --set <theme> <value> Set the theme value
  --reset <theme>     Reset the theme value
  --list-cursors      List installed cursors
  --list-icons        List installed icons
  --list-themes       List installed themes

Themes:
  icons               Icon theme
  controls            Control button theme
  windows             Window border theme
  desktop             Desktop theme
  cursor              Mouse pointer theme

Examples

Below are some examples, as well as the equivalent gsettings command.

Change the icon theme

# gsettings --set org.cinnamon.desktop.interface icon-theme "Mint-X"
themer.sh --set icons "Mint-X"

Change the window border theme

# gsettings --set org.cinnamon.desktop.wm.preferences theme "Mint-Y-Dark"
themer.sh --set windows "Mint-Y-Dark"

Get the controls theme

# gsettings --get org.cinnamon.desktop.interface gtk-theme
themer.sh --get controls

List available desktop themes
```
themer.sh --list-themes
```

Contributing

For contributing to this project, see CONTRIBUTING.

License

See LICENSE for more information.

Contact

Trevor Moon - trevor.r.moon@gmail.com