https://github.com/activexdiamond/actives-bin
A collection of short and useful Arch-/Linux-related scripts. Most are written in Bash.
https://github.com/activexdiamond/actives-bin
Last synced: 15 days ago
JSON representation
A collection of short and useful Arch-/Linux-related scripts. Most are written in Bash.
- Host: GitHub
- URL: https://github.com/activexdiamond/actives-bin
- Owner: ActivexDiamond
- License: mit
- Created: 2025-06-20T00:48:09.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-12-06T04:59:53.000Z (8 months ago)
- Last Synced: 2025-12-09T21:39:22.383Z (8 months ago)
- Language: Shell
- Size: 21.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Active's Bin
A collection of short and useful Arch-/Linux-related scripts. Most are written in Bash.
All scripts are as standalone as possible. No script depends on any other one in this bin, so you are free to snag only a single one; you do not need the entire bin.
Most only require a POSIX system, though other might require extra dependencies such as a window system.
Most are written by me but few are taken from online sources. In those cases, attribution is given in-script.
# Notable Scripts
All scripts have `-h/--help` options which describe their usage. However here is a summary of some of my favourites.
- `create-script`
- Creates a new script(s), in your directory of choice. Sets it to be executable by the current user. And fills it with a nice template. Then opens it using your $EDITOR.
- `get-x11-window-owner`
- Gets the executable responsible for a particular window. Allows selecting your target window with the mouse.
- `sum-video-durations`
- Goes through a given directory (optionally; recursively) and sums the durations of all videos found within.
- `popup-new-file-dialog`
- Brings up a yad dialog with powerful options for creating blank files.
- `popup-date-time-notification`
- Shows a notification with the current date, time, year-week, and unix-time. Useful if you don't like taskbars. :P
# CLI Options
Currently, they all accept Unix-style short options (E,g, `-a`) **and** GNU-style long options (E.g. `--all`).
For options that take an argument, it may either written directly, seperated by a space, or seperated by an equals sign.
I recommend always using an equals, however that is simply a matter of style.
I do my best to follow the best-practices recommended by [The Art of Unix Programming](http://catb.org/~esr/writings/taoup/html/index.html) in his segment about [CLI options](http://catb.org/~esr/writings/taoup/html/ch10s05.html).
**IMPORTANT**: Chaining of Unix-style short options is currently not supported!
Currently, errors for invalid options are not emitted properly. If a script is given more total arguments than it could ever handle, or less than the minimum
A few examples:
```bash
create-script foo
# The below 2 are identical.
create-script foo -b -e
create-script foo --blank --editor
# The below 3 are identical.
create-script -b foo
create-script foo -b
create-script foo --blank
```
However, the following is currently not implemented.
```bash
create-script foo -bn # ERROR: NOT valid!
```
# TODO List
General (mostly `create-script`'s template):
[x] Implement basic option handling.
- [x] Update most scripts with safety features and better exit codes.
- [ ] Implement parsing of chained of Unix-style short options.
- [ ] Implement better parsing of options with arguments.
- [ ] Implement forced positional arguments.
- [ ] Implement support for man pages.
- [ ] Automatically conclude min/max argument count from the argument parsing code / definition.
Per-script (all:
- [ ] Document the non-POSIX dependencies of each script, in its `help` message.
# Credit
Dulfiqar 'Active Diamond' H. Al-Safi
# License
MIT