13 releases (stable)

1.6.0 Apr 13, 2024
1.5.0 Apr 13, 2024
1.4.0 Mar 8, 2024
1.3.0 Feb 26, 2024
0.1.2 Jan 19, 2024

#159 in Images

Download history 4/week @ 2024-09-22 4/week @ 2024-09-29

957 downloads per month

MIT license

19KB
203 lines

Ruin - The battery indicator

Prerequisites

Supported Environments

Usage

  1. Install Ruin:

    cargo install ruin
    
  2. Run the script:

    ruin
    
  3. If you want to set the wallpaper for specific screens (the default behavior is to set the wallpaper on all screens), use the following command:

    ruin -s 0 1
    
  4. If you want to modify the refresh interval (the default is every 5 seconds), use this command:

    ruin -t 1
    

Adding Custom Battery Indicator

  1. Create an image with a #8FBCBB color. Use the following ImageMagick command to convert your image:

    convert input_image.png -fill "#8fbcbb" -colorize 100% output_image.png
    
  2. Copy your image to the config directory:

    cp ./output_image.png ~/.config/ruin/images
    
  3. Run Ruin with the name of your image as an argument:

    ruin output_image
    

Custom Color Scheme

  1. Open the colorschemes.yaml file:

    vim ~/.config/ruin/colorschemes.yaml
    
  2. Add your custom color scheme (colors should be in rgb):

    example:
      charging: [r, g, b]
      default: [r, g, b]
      low_battery: [r, g, b]
      background: [r, g, b]
    
  3. Run the script

    ruin example
    

Inspired by bain.

Dependencies

~28–42MB
~701K SLoC