Git Product home page Git Product logo

kennyssparda / i3-theme-manager Goto Github PK

View Code? Open in Web Editor NEW
1.0 1.0 0.0 12.38 MB

The i3wm Theme Manager is a tool designed to simplify the management of configuration files for the i3 Window Manager. It provides an intuitive interface to change themes, including aesthetic and functional settings, as well as configurations related to multiple monitors.

License: GNU Affero General Public License v3.0

Shell 100.00%
i3-gaps i3wm nitrogen shell-script zenity

i3-theme-manager's Introduction

i3wm Theme Manager

License

License: GPL v3

Overview

The i3wm Theme Manager was created to facilitate the management of i3 Window Manager configuration files, both in terms of aesthetics and functionality. With this tool, you can easily change themes, including settings related to other monitors and their sizes.

Dependencies

The i3wm Theme Manager has the following dependencies:

  • i3-gaps: A fork of the i3 window manager with support for adjustable gaps between windows.
  • Nitrogen: A utility for setting and managing desktop wallpapers, providing an easy way to customize your desktop background.
  • Zenity: A tool that enables the creation of simple graphical interfaces in command-line scripts, making user interaction more convenient.
  • Picom: An X11 window compositor utility that enhances the user experience with visual effects, transparency, and shadowing.

Installation

To install the dependencies on Debian-based systems, run the following command:

sudo apt-get update && sudo apt-get install i3-gaps nitrogen zenity picom

For Arch-based systems, use the following command:

sudo pacman -Syu i3-gaps nitrogen zenity picom

On Fedora, execute the following command:

sudo dnf install i3-gaps nitrogen zenity picom

Installation

To install the i3wm Theme Manager, follow the instructions below:

  1. Clone the repository:
git clone https://github.com/KennysSparda/i3-theme-manager.git ~/.config/i3-theme-manager
  1. Save your current i3 configuration, as the i3wm Theme Manager will overwrite the ~/.config/i3/config file with the corresponding file for the selected theme.

  2. Run the program for the first time:

~/.config/i3-theme-manager/i3-theme-manager.sh
  1. Add the following line to your .bashrc or .zshrc file to allow running the script directly from the terminal:
source ~/.config/i3-theme-manager/i3-theme-manager.sh

Usage and Customization

Vídeo

Example: Creation of new theme

To create a new theme, follow these steps:

  1. Create new directory on ~/.config/i3-theme-manager/themes/my-new-theme
mkdir -p ~/.config/i3-theme-manager/themes/my-new-theme
  1. Place an image file with name "image" in the ~/.config/i3-theme-manager/themes/my-new-theme directory. This image will be associated with the new theme.

  2. Add new entry on zenity menu for my-new-theme in ~/.config/i3-theme-manager/i3-theme-manager.sh file:

# [...]
menu() {
  options=("red" "blue" "green" "purple" "my-new-theme" "Exit")
  theme=$(zenity --list --height="300" --title="Change theme" --column="Themes" "${options[@]}")

  case $theme in
    red|blue|green|purple|my-new-theme)
# [...]
  1. In the configuration file ~/.config/i3-theme-manager/apply-color.sh create new case for your favorite color palette, and add colors in hexadecimal format, like this:
  my-new-theme)
    primarycolor="#ffff00"
    secundarycolor="#333333"
    tertiarycolor="#000000"
    ;;

Example: Configuration of monitors

To change output and size of video, edit this fil: ~/.config/i3-theme-manager/monitor-sizes.sh Change the values according to your preferences. To know about available videos enter the following command:

xrandr --listmonitor

To know all sizes determined video supports enter this:

xrandr

Contribution

If you would like to contribute to the i3wm Theme Manager, please follow the guidelines below:

  • Fork the repository on GitHub.
  • Make your desired changes.
  • Submit a pull request describing your changes and the rationale behind them.

We welcome contributions from the community and appreciate any feedback or suggestions.

First-time Execution

After completing the installation, run the i3wm Theme Manager for the first time using the following command:

i3-theme-manager.sh

Or pressing Win+t

Be sure to read the documentation provided with the i3wm Theme Manager for more information on how to use all available features. If you have any questions or suggestions, feel free to contact us.

Contact

You can reach me through the following channels:

i3-theme-manager's People

Contributors

kennyssparda avatar

Stargazers

 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.