Yui is a utility manager that provides the user with a CLI menu with various functions, from image edit to file management. You are very welcome to fork it and modify so that it becomes your utility manager!

I use this awesome survey lib for this app.

Installation and use

To install, run this

python -m pip install git+https://github.com/yurimimi/yui.git@master

To make it show up in your command line, just call

yui

or

python -m yui

You can also call a function by it's name as an argument

yui <function>

Utils

• File management

  • Normalize filenames in a directory

  normalize_filenames removes 'bad' symbols and trailing whitespaces. Got it here.

  • Generate .gitignore for a specific project (WIP)

  Does not work yet.

• Image operations

  • Crop image

  crop_image crops the image from its edges based on the specified range of pixels. The parameters order is like CSS's padding and margin.

  • Expand image

  expand_image works like crop_image but inversely: it expands the image at the edges filling the area with transparency.

  • Add background (WIP)

  Does not work yet.

• System related

  • Check battery(-ies)

  battery_check shows the percentage of the current battery charge. It takes either one arg - the battery number, or shows the summary charge if no argument was provided.

  • Set brightness

  set_brightness calls xrandr to set the brightness with a value specified as an argument here. The argument can be an absolute value, e.g., 100 or 75, or a relative one like -15 or +5.

Contrib

Please don't hesitate to add stuff and fix grammatical and other mistakes in the text (comments, docs, etc.) because I'm just learning English. It'll help me a lot. :)

Todo

• categorise utils
• select multiple utils to run
  • specify order of exectution
• better navigation