/yui

A simple project of mine to learn Linux and Python.

Primary LanguagePythonThe UnlicenseUnlicense

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

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