Add commands

Author: SimonSchubert

README.md

@@ -2,7 +2,7 @@
 
 ![Icon](https://raw.githubusercontent.com/SimonSchubert/LinuxCommandLibrary/master/art/web_hi_res_144.png)
 
-The app currently has **4299** manual pages, **23+** basic categories and a bunch of general terminal tips. It works 100% offline, doesn't need an internet connection and has no tracking software.
+The app currently has **4420** manual pages, **23+** basic categories and a bunch of general terminal tips. It works 100% offline, doesn't need an internet connection and has no tracking software.
 
 [![Play Store](https://raw.githubusercontent.com/SimonSchubert/LinuxCommandBibliotheca/master/art/play_store_badge.png)](https://play.google.com/store/apps/details?id=com.inspiredandroid.linuxcommandbibliotheca)
 [![F-Droid](https://raw.githubusercontent.com/SimonSchubert/LinuxCommandBibliotheca/master/art/fdroid_badge.png)](https://f-droid.org/en/packages/com.inspiredandroid.linuxcommandbibliotheca/)

assets/commands/1password.md

@@ -0,0 +1,106 @@
+# TLDR
+
+**Sign in** to a 1Password account
+
+```op signin```
+
+**List all items** in a vault
+
+```op item list --vault [vault_name]```
+
+**Get details** of a specific item
+
+```op item get "[item_name]"```
+
+**Get specific fields** from an item
+
+```op item get "[item_name]" --fields label=username,label=password```
+
+**Read a secret** using a secret reference
+
+```op read "op://[vault]/[item]/[field]"```
+
+**Run a command** with secrets injected as environment variables
+
+```op run --env-file [.env] -- [command]```
+
+**Create a new item** in a vault
+
+```op item create --category login --title "[title]" --vault [vault_name]```
+
+**List all vaults** in the account
+
+```op vault list```
+
+# SYNOPSIS
+
+**op** [_command_] [_subcommand_] [_flags_]
+
+# PARAMETERS
+
+**account**
+> Manage locally configured 1Password accounts
+
+**item**
+> Perform CRUD operations on vault items (get, list, create, edit, delete)
+
+**vault**
+> Manage vaults and their permissions
+
+**document**
+> Manage document-type items (get, list, create, edit, delete)
+
+**read**
+> Resolve and retrieve secret references
+
+**run**
+> Pass secrets as environment variables to a subprocess
+
+**inject**
+> Insert secrets into configuration files or templates
+
+**signin**
+> Authenticate to a 1Password account
+
+**signout**
+> End the current session
+
+**whoami**
+> Display information about the signed-in account
+
+**completion**
+> Generate shell completion scripts
+
+**--format** _json_
+> Output results in JSON format for parsing with tools like jq
+
+**--fields** _label=field_
+> Specify particular fields to retrieve from an item
+
+**--vault** _name_
+> Target a specific vault for the operation
+
+**--cache=false**
+> Disable daemon caching (useful in restricted environments)
+
+# DESCRIPTION
+
+**op** is the official command-line interface for 1Password, a password manager and secrets management platform. It enables secure access to passwords, credentials, and sensitive data directly from the terminal.
+
+The CLI follows a noun-verb command structure where the first argument is typically a resource type (item, vault, user) followed by an action (get, list, create). It supports both interactive and scripted workflows, making it suitable for development automation and CI/CD pipelines.
+
+Key capabilities include retrieving credentials using secret references in the format **op://vault/item/field**, injecting secrets into environment variables for running processes, and managing vault contents programmatically. The tool uses daemon-based caching on Unix systems to improve performance and reduce API calls.
+
+Items can be referenced by name or by their 26-character alphanumeric ID, with IDs being more stable and efficient for automation. Output can be formatted as JSON for integration with tools like **jq**.
+
+# CAVEATS
+
+Requires a 1Password account and must be authenticated before most operations. The daemon caching feature stores encrypted data in memory, which may not be suitable for all security environments—use **--cache=false** to disable. Service accounts have different authentication flows than personal accounts.
+
+# HISTORY
+
+1Password was founded by **AgileBits** in **2006** as a password manager for macOS. The command-line interface was first released in **2017** to support developer workflows and automation. Version 2 of the CLI, released in **2022**, introduced the current noun-verb command structure, secret references, and improved service account support for CI/CD integration.
+
+# SEE ALSO
+
+[pass](/man/pass)(1), [gopass](/man/gopass)(1), [vault](/man/vault)(1), [gpg](/man/gpg)(1)

assets/commands/aa-notify.md

@@ -0,0 +1,78 @@
+# TLDR
+
+**Display summary** of AppArmor denials since last login
+
+```aa-notify --since-last```
+
+**Show summary** for the last N days
+
+```aa-notify --since-days [7]```
+
+**Poll logs** and display desktop notifications
+
+```aa-notify --poll --user [username] --display $DISPLAY```
+
+**Search a specific file** for AppArmor messages
+
+```aa-notify --file [/var/log/audit/audit.log]```
+
+**Show verbose messages** with summaries
+
+```aa-notify --since-days [3] --verbose```
+
+**Wait before displaying notifications** (useful at startup)
+
+```aa-notify --poll --wait [10]```
+
+# SYNOPSIS
+
+**aa-notify** [_options_]
+
+# PARAMETERS
+
+**-p**, **--poll**
+> Poll AppArmor logs continuously and display desktop notifications for DENIED messages
+
+**-f** _FILE_, **--file=**_FILE_
+> Search FILE for AppArmor messages instead of the default log locations
+
+**-l**, **--since-last**
+> Show summary of messages since last login
+
+**-s** _NUM_, **--since-days=**_NUM_
+> Show summary of messages for the last NUM days
+
+**-u** _USER_, **--user=**_USER_
+> Drop privileges to USER when running privileged; required with --poll for desktop notifications
+
+**-w** _NUM_, **--wait=**_NUM_
+> Wait NUM seconds before displaying notifications (useful for autostart)
+
+**--display** _$DISPLAY_
+> Set the DISPLAY environment variable for desktop notifications
+
+**-v**, **--verbose**
+> Show full messages along with summaries
+
+**-h**, **--help**
+> Display usage information
+
+# DESCRIPTION
+
+**aa-notify** displays information about logged AppArmor security events, specifically DENIED messages that occur when applications attempt actions blocked by their AppArmor profiles.
+
+The tool operates in two modes: summary mode shows a report of past denials from a specified time period, while poll mode continuously monitors logs and delivers desktop notifications in real-time. This makes it useful for both auditing historical security events and receiving immediate alerts about policy violations.
+
+AppArmor messages are read from the systemd journal, **/var/log/syslog**, **/var/log/kern.log**, or **/var/log/audit/audit.log** when auditd is installed. The tool requires appropriate privileges to read these logs, typically running under sudo.
+
+# CAVEATS
+
+Desktop notifications require a running display server and proper DISPLAY environment variable configuration. When using sudo, the DISPLAY variable may be reset, requiring explicit **--display** specification. For systems with auditd, the log file path must be explicitly set with **--file /var/log/audit/audit.log**.
+
+# HISTORY
+
+**aa-notify** is part of the AppArmor utilities suite. AppArmor originated at Immunix in the late **1990s** and was acquired by Novell in **2005**. It became part of the mainline Linux kernel in version **2.6.36** released in **2010**. The notification daemon was added to help administrators monitor security events in desktop environments.
+
+# SEE ALSO
+
+[apparmor](/man/apparmor)(7), [aa-status](/man/aa-status)(8), [aa-enforce](/man/aa-enforce)(8), [aa-complain](/man/aa-complain)(8), [journalctl](/man/journalctl)(1)

assets/commands/aafire.md

@@ -0,0 +1,73 @@
+# TLDR
+
+**Display ASCII fire** animation in the terminal
+
+```aafire```
+
+**Run with curses driver** (force terminal output)
+
+```aafire -driver curses```
+
+**Run with slang driver** for terminal display
+
+```aafire -driver slang```
+
+**Display with specific dimensions**
+
+```aafire -width [80] -height [25]```
+
+# SYNOPSIS
+
+**aafire** [_aalib-options_]
+
+# PARAMETERS
+
+**-driver** _name_
+> Select output driver (curses, slang, X11, etc.)
+
+**-width** _n_
+> Set display width in characters
+
+**-height** _n_
+> Set display height in characters
+
+**-bold**
+> Enable bold font for brighter output
+
+**-dim**
+> Use dim characters for darker appearance
+
+**-reverse**
+> Use reverse video mode
+
+**-normal**
+> Use normal rendering mode
+
+**-extended**
+> Use extended ASCII character set
+
+**-eight**
+> Use eight-bit ASCII characters
+
+**-help**
+> Display available options and drivers
+
+# DESCRIPTION
+
+**aafire** displays an animated fire simulation rendered entirely in ASCII art characters. It is a demonstration program for the aalib library, which converts graphical output into text-based representations.
+
+The animation renders flames that flicker and dance in real-time using only standard text characters, creating a visually interesting effect directly in the terminal or in an X11 window. The program demonstrates aalib's ability to represent complex visual information using nothing but ASCII characters and their brightness levels.
+
+By default, aalib may attempt to use a graphical driver. To ensure output stays in the terminal, use the **curses** or **slang** driver explicitly.
+
+# CAVEATS
+
+The default driver may attempt to open an X11 window rather than display in the terminal. Use **-driver curses** or **-driver slang** to force terminal output. Performance depends on terminal emulator capabilities and may vary across different systems.
+
+# HISTORY
+
+**aafire** is part of the aalib (ASCII Art Library) created by **Jan Hubicka** in the late **1990s**. The library was developed to enable ASCII art rendering for various applications and became popular for its creative approach to displaying graphics in text-only environments. It gained wider recognition through projects like MPlayer which used aalib to play video as ASCII art.
+
+# SEE ALSO
+
+[bb](/man/bb)(1), [aview](/man/aview)(1), [asciiview](/man/asciiview)(1), [cmatrix](/man/cmatrix)(1), [sl](/man/sl)(1)

assets/commands/abcde.md

@@ -0,0 +1,125 @@
+# TLDR
+
+**Rip a CD** to the default format (usually Ogg Vorbis)
+
+```abcde```
+
+**Rip a CD** to MP3 format
+
+```abcde -o mp3```
+
+**Rip a CD** to FLAC format
+
+```abcde -o flac```
+
+**Rip to multiple formats** simultaneously
+
+```abcde -o flac,mp3,ogg```
+
+**Rip using multiple CPU cores** for faster encoding
+
+```abcde -j [4]```
+
+**Rip in non-interactive mode** (no prompts)
+
+```abcde -N```
+
+**Rip specific tracks** from a CD
+
+```abcde [1] [3] [5]```
+
+**Rip from a specific CD device**
+
+```abcde -d [/dev/sr0]```
+
+# SYNOPSIS
+
+**abcde** [_options_] [_tracks_]
+
+# PARAMETERS
+
+**-o** _format_
+> Output format: mp3, ogg, flac, opus, m4a, wav, spx, mpc, mka, wv, ape, mp2, tta, aiff
+
+**-d** _device_
+> Specify CD device (default: /dev/cdrom)
+
+**-j** _n_
+> Run n encoding processes simultaneously (for multi-core systems)
+
+**-a** _actions_
+> Specify actions: cddb, read, normalize, encode, tag, move, replaygain, playlist, clean
+
+**-N**
+> Non-interactive mode; never prompt for input
+
+**-n**
+> Skip CDDB lookup; use generic track names
+
+**-1**
+> Encode entire CD as a single track
+
+**-c** _file_
+> Use specified configuration file
+
+**-C** _discid_
+> Use specified CDDB disc ID for lookup
+
+**-p**
+> Pad track numbers with leading zeros
+
+**-P**
+> Use Unix pipes for encoding (reduces disk usage)
+
+**-r** _host_
+> Remote ripping from specified host
+
+**-S** _speed_
+> Set CD drive read speed
+
+**-t** _n_
+> Start numbering tracks from n
+
+**-T** _n_
+> Same as -t but also modifies playlist
+
+**-x**
+> Eject CD after ripping completes
+
+**-w** _comment_
+> Add comment to encoded files
+
+**-W** _n_
+> Set disc number for multi-disc albums
+
+**-k**
+> Keep wav files after encoding
+
+**-l**
+> Use low disk space mode
+
+**-V**
+> Show version information
+
+**-h**
+> Display help message
+
+# DESCRIPTION
+
+**abcde** (A Better CD Encoder) is a shell script that automates the process of ripping audio CDs and encoding them to various compressed formats. It handles the entire workflow from reading the disc to tagging the final files.
+
+The tool queries online databases (CDDB, MusicBrainz) to automatically retrieve track names, artist information, and album details. It uses backend programs like **cdparanoia** for secure ripping and encoders like **lame**, **oggenc**, **flac**, and **opusenc** for compression.
+
+Multiple output formats can be generated in a single pass, and the encoding can be parallelized across multiple CPU cores using the **-j** option. Configuration is managed through **/etc/abcde.conf** or **~/.abcde.conf**, allowing customization of encoder settings, output paths, and naming conventions.
+
+# CAVEATS
+
+Requires backend programs for ripping (cdparanoia or cdda2wav) and encoding (lame for MP3, oggenc for Ogg, flac for FLAC, etc.) to be installed separately. CDDB lookups require network connectivity. Some encoders like lame may need to be installed from non-free repositories due to patent considerations.
+
+# HISTORY
+
+**abcde** was created by **Robert Woodcock** in **1998** as a simple way to automate CD ripping on Linux systems. The name stands for "A Better CD Encoder," reflecting its goal of simplifying what was previously a multi-step manual process. It has been actively maintained and expanded to support modern formats like Opus and AAC while remaining a pure shell script.
+
+# SEE ALSO
+
+[cdparanoia](/man/cdparanoia)(1), [lame](/man/lame)(1), [flac](/man/flac)(1), [oggenc](/man/oggenc)(1), [opusenc](/man/opusenc)(1), [cd-discid](/man/cd-discid)(1)