Here's the --help for each shell script:
usage: 7ze file [archive.zip]
Add 'file' to AES256 enctrypted archive.
If the name of the archive is not given then
'file.zip' will be used as archive name.
Archive with file encrypted in this way should
be compatible with windows.
7ze will ask for the password.
usage: ansible-password-file-from-ansible.cfg [ansible_vault_parameters]*
ansible-password-file-from-ansible.cfg --help
See `ansible-password-file-from-ansible.cfg-wrapper --help` for
further help
usage: ANSIBLE_COMMAND_WITH_PASSWORD_FILE_FROM_ANSIBLE_CFG=[ansible-vault|ansible-playbook|ansible] ansible-password-file-from-ansible.cfg-wrapper [ansible_command_parameters]*
ansible-password-file-from-ansible.cfg-wrapper --help
ansible-password-file-from-ansible.cfg-wrapper --clear
This is a wrapper for ansible commands. It will get
the vault_password_file from ansible.cfg if the
latter exists and execute the ansible command with it.
ANSIBLE_COMMAND_WITH_PASSWORD_FILE_FROM_ANSIBLE_CFG contains the
name of the ansible command to execute.
More precisely it will check if there's a ansible.cfg
in the same directory that the script has been called that
contains a line:
#vault_password_file = ansible/vault/file
and if it does will:
* `export ANSIBLE_VAULT_PASSWORD_FILE=ansible/vault/file`
* call the ansible command with all the parameters given on
the command line
The idea of this script is to work with vault_password_files
on a team, where not everybody has vault_password_files
set up.
So those that *have* vault_password_files set up can
add the respective comment line as shown above to the
ansible.cfg file and have ansible-playbook use that
automatically.
Note that:
* this way different vault_password_files can be set up
per ansible repo
* those in the team that do use vault_password_files need
to have them located at the same place
--clear: will call the `vault_password_file` with a
parameter `--clear` in orderr to clear a
possible (wrong) password that is remembered/cached
by the `vault_password_file`/pin entry program
usage: ansible-playbook-password-file-from-ansible.cfg [ansible_vault_parameters]*
ansible-playbook-password-file-from-ansible.cfg --help
See `ansible-password-file-from-ansible.cfg-wrapper --help` for
further help
usage: ansible-vault-password-file-from-ansible.cfg [ansible_vault_parameters]*
ansible-vault-password-file-from-ansible.cfg --help
See `ansible-password-file-from-ansible.cfg-wrapper --help` for
further help
usage: ansible-vault-rgrep [-H] directory [GREP_PARAMS]
ansible-vault-rgrep --help
Recursively grep ansible vault files.
-H prefix each match with the filename
You should either set `DEFAULT_VAULT_PASSWORD_FILE`
or set `vault_password_file` in your ansible
config file, otherwise ansible-vault-rgrep will
be hardly useful.
These bash_aliases need to be called from ~/.bashrc or similar like this:
. /path/to/this/bash_aliases
They provide the following commands:
ackp - execute "ack --pager="less -R""
df - execute "df -h"
du - execute "du -h"
bc - allow for calculations with decimal places by default in bc
hg - grep shell history
hl - page shell history
pg - grep processes
rgl - rgrep regex | less
rgp - execute "rg --color=ansi | less -R"
rgpc - execute "rg --color=ansi -C 25 | less -R"
aps - execute 'ansible-playbook setup.yml'
apst - execute 'ansible-playbook setup.yml --tags='
apsv - execute 'ansible-playbook setup.yml \
--vault-password-file ~/vault_from_gpg_agent.py
apstv - execute 'ansible-playbook setup.yml \
--vault-password-file ~/vault_from_gpg_agent.py \
--tags='
apt-find file - say which Debian package contains "file"
needs apt-file
Shortcuts to put firefox, chrom(e|ium) or thunderbird to rest.
Requires {firefox,thunderbirf,chrome}-sleep/wake
chs, chw, ffs, ffw, ths, thw
git shortcuts
g - status
gd - diff
ga - add
gac - add and commit, commit msg is optional
gc - commit
gca - commit -a
gcam - commit -a -m
gci - commit --interactive
chmod shortcuts (not available in zsh)
+x file
+r file
+w file
a+x file
a+r file
a+w file
change directory
cdreal file - chdir to wherever the file is located
cdwhich file - chdir to wherever the executable is located
mcd name - make directory and cd into it
mcdt - make temporary directory and cd into it
mcptmp file - make temporary directory, cp given file into it
and cd into the tmp dir. Supports the same
options as cptmp.
mcdnow [text] - create directory whose name is the current date
plus optionally the text and cd into it
usage: brightness [--show|percent]
set or show panel brightness on intel chips in percent (default is 60%)
usage: bromium [--enable-cookies] [--userdir /path/to/userdir] [URL]
bromium --help
Run chromium with an empty temporary profile
or with a given directory.
By default bromium will run in "incognito"
mode. If you want to allow cookies then
use --enable-cookies
If you are using bromium as a privacy tool
then you may want to consider changing your
default search provider. See
https://stackoverflow.com/a/50888866
--enable-cookies - do not run in incognito mode
--userdir $DIR - run from a given user directory. This
can be used to prepare a specific
configuration for a specific application
and then use that directory only for that
application.
When run with --userdir, cookies will
be *enabled*.
How to prepara a special userdir:
1. terminate all chromium browser
2. move your original chromium configuration to the side
`mv ~/.config/chromium ~/.config/chromium.your-original-config`
3. start chromium
4. configure whatever you need
5. terminate chromium
6. move the config to the side
`mv ~/.config/chromium ~/.config/chromium.my-special-config`
7. restore your original config
`mv ~/.config/chromium.your-original-config ~/.config/chromium`
8. now you can use your special config with bromium
`bromium --userdir ~/.config/chromium.my-special-config $SOME_APPLICATION_URL`
usage: catnamed file ...
print name of file and then cat it
usage: cat_null_terminated file
cat_null_terminated --help
When file contains "lines" or "items" separated
by null values, then cat_null_terminated will
replace those nulls with line breaks and `cat`
the file out
Many special files under /proc contain such
null-separated lines.
see https://unix.stackexchange.com/a/29132
usage: catwhich executable
cat executable that is somewhere in $PATH
or can be located via "locate"
usage: cert-fingerprint certificate.crt
cert-fingerprint --help
print fingerprint of x509 certificate
usage: cert-server-add remote.host.name [port]
cert-server-add --help
connects to server, retrieves its certificate and
adds it to the local system's trusted certificates
ATTENTION:
* No checks on the retrieved certifica are done,
f.ex. if it claims to be a CA certificate etc.
* the certificate is put under /etc/ssl/certs/,
which is probably not entirely compatible
accross all distributions
usage: cert-show (--type TYPE) (--der|--pem) (--help|certificate|--host host:port [--smtp|--postgres])
usage: cert-show certificate
usage: cert-show --help
print all kinds of certificates
the following extensions are automatically recognized:
p7b -> pkcs7
pfx|p12 -> pkcs12
key -> rsa private key
csr -> certificate signing request
crl -> certificate revocation list
cer|der|crt|pem -> certificates
you can force a type with `--type one_of_the_extensions_above`
TODO:
I am not sure: will openssl autorecognize formats?
you can force a format with `--der` or `--pem`
usage: cert-show-all [--debug] [certificates.crt]
cert-show-all --help
print all certificates contained in certificates.crt chain
--debug include original encoded certificates in printout
usage: changelog
edit the user's system changelog
usage: chrome-sleep
suspend all chrome/chromium processes
Note: it's advisable to add an 'alias chs=chrome-sleep'
See also: chrome-wake
usage: chrome-wake
wake up all chrome/chromium processes
Note: it's advisable to add an 'alias chw=chrome-wake'
See also: chrome-sleep
usage: chromium-create-private-profile SHORTCUT URL
chromium-create-private-profile --help
PURPOSE:
Will create a clean, private, dedicated profile for
a web site that you can call from the command line
via shortcut.
DETAILS:
Will create an executable under ~/bin/SHORTCUT that
will use a clean, private chromium config and data
directory under ~/.local/chrome-SHORTCUT.
You can customize ~/bin/SHORTCUT as you wish.
By default it will use `bromium --enable-cookies`
to access the given URL.
The ~/.local/chrome-SHORTCUT directory will
be created (copied) from the
~/.config/chromium.fresh-after-start.with_titlebar
template.
You will need to create the
template ~/.config/chromium.fresh-after-start.with_titlebar
once and can use it after with
chromium-create-private-profile. Create the template
as follows:
* `mv ~/.chromium ~/.chromium.original`
(do not overwrite a previously existing
~/.chromium.original !)
* `chromium` # will create a fresh ~/.chromium
* configure chromium as you wish
* terminate chromium
* `mv ~/.chromium ~/.config/chromium.fresh-after-start.with_titlebar`
* `mv ~/.chromium.original ~/.config/chromium`
(restore original chromium config)
usage: copy_args_to_clip arg1 arg2 ...
copy arguments to clipboard (CTRL-V)
if no argument is given, then copy stdin to clipboard
usage: copy_args_to_file file_name arg1 arg2 ...
copy arguments to file
if no argument is given, then copy stdin to clipboard
usage: copy_file_to_clip [file]
copy file to clipboard (CTRL-V)
if no file is given, copies stdin
usage: copy-resolv-conf destination_machine
copy-resolv-conf --help
Copies your /etc/resolv.conf over to the destination_machine
usage: copy_sel_to_clip
copy selection (mouse select) to clipboard (CTRL-V)
usage: copy_stdin_to_file file_name
copy input to file
usage: cptmp [--dir] [opts] file
copy given file to /tmp/foo.XXXXX
cptmp accepts the same arguments as cp
--dir /tmp/foo.XXXXX will be a directory
usage: dmesgt
dmesgt --help
Output dmesg with not broken timestamps.
usage: docker-cleanup
docker-cleanup --help
Will remove:
- stopped containers
- dangling volumes
- unused networks
- images without repository and without tag (<none> <none>)
- older versions of images with identical repository and tag
- dangling images
usage: docker_list_depdendent_images [-nh] [-v] [-r] IMAGE_ID
docker_list_depdendent_images --help
-nh - do not output header
-v - verbose image info output
-r - recursive (dependencies of depencies)
(TODO: doesn' work yet)
usage: dpkg-which EXECUTABLE
dpkg-which --help
find EXECUTABLE in $PATH and display in which
Debian package it is.
usage: executable_wrapper (unwrap|wrap|test) executable
This script is used to wrap executables in order to
analyse how they are called by other scripts, daemons etc.
The original file will be renamed to `executable.orig`.
It will log all parameters and the environment of the
originally called executable to a log file for inspection.
The log file will be called `/tmp/executable.log.XXXXXX`,
where 'XXXXX' will be some random string.
wrap - wrap the given `executable`
unwrap - unwrap the given `executable`
test - test this script
usage: exif-del [--nocopy] image
remove all meta-tags from exif informations
--nocopy - do not preserve original image
usage: fff [params]*
fff --help
Ask whether to run firefoxium or firefox
and then run it.
Depends on `kdialog`.
usage: file_chooser
file_chooser --help
Opens a ncurses file selection dialog that
allows you to navigate through the file system
and to select a file.
The full path of the file will be output to STDOUT
usage: file_extension [--lowercase|--uppercase] file_path
print file extension of given file
usage: findhere SEARCH_STRING [OTHER_FIND_OPTIONS]
will execute "find . -iname "*SEARCH_STRING*" [OTHER_FIND_OPTIONS]"
usage: find_ls_sort [--help]
A fusion of find and ls. Very useful for comparing systems.
usage: firefoxium [URL|firefox arguments]
firefoxium --help
Run firefox in a jail with a fresh profile.
Depends on `firejail`.
usage: firefox-sleep
suspend all firefox (and plugin) processes
Note: it's advisable to add an 'alias ffs=firefox-sleep'
See also: firefox-wake
usage: firefox-wake
wake up all firefox (and plugin) processes
Note: it's advisable to add an 'alias ffw=firefox-wake'
See also: firefox-sleep
usage: firejail_browser
firejail_browser --help
This script lists you the running firejails,
lets you select one from the menu and lets you
execute an action on that firejail:
* get a file from that jail: will option a
file selection dialogue inside the jail
* put a file into the jail (currently not
implemented)
* open a shell in the jail
Put and get require you to have the
https://github.com/tpo/little_shell_scripts/blob/master/file_chooser
script installed in a standard binary path.
usage: git_show_upstream_log
git_show_upstream_log --help
Show git log of upstream repo
usage: gmaps
gmaps --help
Access Google maps
usage: google query
google --help
usage: sudo googleads-doubleclick allow|block
googleads-doubleclick --help
Will un/comment the `127.0.0.2 googleads.g.doubleclick.net`
entry in `/etc/hosts`.
This serves to black/whitelist that
host as needed in order to access google services which
redirect via that host if the respective cookie is not set
You probably want something like this:
user ALL=NOPASSWD: /path/to/googleads-doubleclick allow
user ALL=NOPASSWD: /path/to/googleads-doubleclick block
usage: google-wrap [arguments]
google-wrap --help
Wrap google web sites. google-wrap will:
* allow googleads-doubleclick access
* execute `bromium [arguments]`
* disallow googleads-doubleclick access
usage: gtranslate
gtranslate --help
Access Google Translate
usage: heat.sh
run infinite loop that will consume 100% of a CPU core
Useful for fan and temperature regulation testing
usage: host_only_ip hostname
host_only_ip --help
Same as `host`, but will return IP address only.
usage: hosts allow|block|status FQDN
hosts --help
adds or comments out an entry in /etc/hosts like this:
$ grep FQDN /etc/hosts
127.0.0.2 FQDN
thereby blockin or allowing access to the FQDN
ATTENTION: no checks are made on well-formed-ness of the
provided FQDN
usage: kernelog
Will jump to the end of /var/log/kern.log, page it with
'less' and update it when it changes.
usage: kill_citrix
kill_citrix --help
For some reason citrix client infrastructure wants
to run all the time and keep on wasting resources
even when it's not in use. This script kills all
those Citrix daemons.
usage: kill_ssh destination
kill_ssh --help
kills ssh processes currenctly connecting to
the given destination
usage: konsole_fork_ssh
konsole_fork_ssh --help
Fork a konsole tab that is running a ssh session.
The idea is to bind this program to a key-combination
and press the respectiv key while working inside konsole.
When the currently active tab is running a ssh session,
konsole will open a new Tab and execute ssh to the same host.
usage: linechop
linechop --help
chop lines of at right margin of the screen
usage: mairi _search _parameters
mairi searches your mail and displays results in mutt
mairi is a simple wrapper around mairix and mutt and accepts
the same parameters as mairix
usage: mcdts
mcdts --help
Open shell in new temporary directory, delete directory after exit
usage: meetjits [handle|--list|--help|URL]
--list will dump your config
Otherwise will start bromium on the
given Jitsi Meet channel or on the give URL.
You can configure your channels like this:
$ cat ~/.meetjitsi.yaml
urls:
default: https://meet.jit.si/example-default
myown: https://meet.jit.si/example-myown
Jitsi Meet uses 4000 - 6000kbps.
mkdir-now [--full] [--no-create] [--ignore-existing] [--script|-s] [--name TEXT]
creates a directory named by the current date. F.ex.
$ mkdir-now
Created "2010-01-22/"
--script will only return name of created dir on stdout
-s same as --script
--no-create don't create dir, only return name of dir that would be
--ignore-existing do not error out if directory already exists
--full create directory with full date, such as
2010-01-22_20:26/
--name TEXT will allow you to add so string to the name
of the created directory. F.ex.
$ mkdir-now -name "researching segfault"
Created "2010-01-22 researching segfault/"
./modinfo_all : list information on all currently installed kernel modules
./modinfo_all --desc : list only description of each module
usage: mount_encrypted [options] image [mountpoint]
see also umount_encrypted
if mountpoint is not provided mounts under /media/image
--ro mount read only
usage: mount_iso iso_image destination
mount_iso --help
usage: mount_stuff_into_chroot [--umount] path_to_chroot
mount_stuff_into_chroot --help
Mounts /proc /sys and /dev into chroot
and makes sure /tmp is correctly set up.
With --umount: umounts all those filesystems
again, that were previously mounted into
the chroot.
usage: mv_ln src_ln dest_dir
mv_ln --help
Move the symbolic link src_ln into dest_dir while
keeping it relative
usage: netstat_cmdline [netstat_options]*
netstat_cmdline --help
netstat_cmdline will call netstat and replace
the program name with the full command line
See `netstat --help` for all possible options
Note: netstat_cmdline works, but is slow and is
a hack (see its source code). It'd be
better to add a respective option to
netstat itself. Or to use `ss`, whose
output seems to be more robust to parse.
usage: pas
suspend all pulseaudio processes
See also: paw
usage: paw
wake up and restart all pulseaudio processes
See also: pas
usage: psa [-w] [pattern]
Show all processes in full detail (ps faux) excluding kernel
processes. If a pattern is given, then the process list is
grep'ed with that pattern.
psa will by default chop off long lines.
-w wrap lines instead of chopping them off
psa depends on the linechop tool.
usage: psql_access_priv_decoder
psql_access_priv_decoder --help
Will decode access privileges displayed by psql
How to use:
1. in `psql` do `\l accounting` or such to list the database "accounting".
2. copy the output including the header
3. start psql_access_priv_decoder
4. paste
5. CTRL-D
6. you will get the access privileges in human readable form displayed
Example:
$ psql
postgres=# \l accounting
List of databases
Name | Owner | Encoding | Collate | Ctype | Access privileges
--------------+------------+----------+-------------+-------------+--------------------------
accounting | henry | UTF8 | en_US.UTF-8 | en_US.UTF-8 | =T/postgres +
| | | | | henry=CTc/postgres +
| | | | | alice=c/postgres
$ psql -c "\l accounting" | psql_access_priv_decoder
"=T/accounting" means:
role "postgres" allowed "PUBLIC" to:
T -- create TEMPORARAY tables while using the DB
"henry=CTc/accounting" means:
role "postgres" allowed "henry" to:
C -- CREATE new tables/schemas
c -- CONNECT to DB
T -- create TEMPORARAY tables while using the DB
"alice=c/accounting" means:
role "postgres" allowed "alice" to:
c -- CONNECT to DB
usage: rasa-download
rasa-download --help
download currently playing song on rasa.ch
usage: realpath_to_clip [FILE]
realpath_to_clip --help
Copies to realpath of FILE to the clipboard.
If file is not given, then the current
directory is used.
Depends on: copy_file_to_clip
usage: reset_usb_devices
resets all USB devices that the script finds
usage: select_lines (only-left|only-right|in-both) left_file right_file
select_lines --help
Depending on first argument will emit a list of
lines that are either only in the left, the right
or in both files.
(The script will create sorted temporary copies
of both files...)
Thanks to mr.spuratic in https://stackoverflow.com/a/18205289
usage: show_csv [file.csv] [separator]
show_csv --help
pretty print and page CSV file with 'less'
usage: show_rh_updates [--help]
shows current and new version of packages that would get
updated.
usage: ssh-host [host]
Host lookup inside ~/.ssh/config. If no host
is given then output the whole ~/.ssh/config file.
This script is most useful together with bash
completion:
_ssh_host()
{
local cur prev words cword
_init_completion -n = || return
_known_hosts_real -a -F ~/.ssh/config "$cur"
} && complete -F _ssh_host ssh-host
usage: ssh-show-host-keys HOST
ssh-show-host-keys --help
HOST should be the same host you use to connect
to the host
This commend will ssh to the host and display all
its public keys
usage: (ssh-update-config|ssh-update-config-template)
Construct a new ~/.ssh/config from ~/.ssh/config.d.
A backup of the current ~/.ssh/config is done
automatically.
If called as `ssh-update-config` then:
* ~/.ssh/config.d/* is `cat`ed together and
the result used as ~/.ssh/config
If called as `ssh-update-config-template` then:
* ~/.ssh/config.d/main.template is
`source`d instead and the result written to
~/.ssh/config
ssh-update-config requires the `versioned_backup`
script
usage: ssh-wait [--no-multiplex] host
ssh-wait --help
wait for ssh to become available
usage: start_dependent_systemd_service serviceA serviceB
start_dependent_systemd_service serviceA serviceB --help
Will watch/monitor dbus for systemd events and will start
serviceB when it sees that serviceA has started.
ATTENTION: this script will NOT sanitize the serviceA
or serviceB parameters and pass them straight
to awk and the shell!!! YOU HAVE BEEN WARNED!!!
Dependencies: gdbus, awk
Note: this script was originally created to solve the
following problem:
* you start some containers with `docker-compose`
* you (or something) does
`systemctl stop docker; systemctl stop docker`
* your "docker-compose containers" will not get
started...
To solve this particular problem you better use
`restart: until-stopped`.
usage: switch_off_radeon
tries to switch off the heat producing Radeon VGA card
usage: t.co
t.co --help
temporarily allow access to t.co
This script will allow t.co access and wait for a
keypress. The assumption is that you want to keep
t.co blocked and only want to shortly enable it
when clicking on a link on Twitter
This script needs the `hosts` script
usage: thunderbird-sleep
suspend all thunderbird processes
Note: it's advisable to add an 'alias tbs=thunderbird-sleep'
See also: thunderbird-wake
usage: thunderbird-wake
wake up all thunderbird processes
Note: it's advisable to add an 'alias tbw=thunderbird-wake'
See also: thunderbird-sleep
usage: timeout_pg seconds [--pg] command [parameters]*
Run command and send SIGTERM to it after given seconds.
--pg - send kill to the command's process group and
thus kill the command and all of its children
usage: to_jpg image.png [image.jpg]
transform png image to jpg format
usage: umount_encrypted mountpoint
see also mount_encrypted
usage: versioned_backup filename [.file_extension]
makes a versioned backup of filename. If provided
then the version number will be inserted before the
.file_extension
Example:
$ ls
foo
$ versioned_backup foo
$ ls
foo
foo.0001
$ versioned_backup foo
$ ls
foo
foo.0001
foo.0002
$ touch bar.mp3
$ versioned_backup bar.mp3 .mp3
$ ls
foo
foo.0001
foo.0002
bar.mp3
bar.0001.mp3
usage: vimgrep (REGULAR_EXPRESSION|rg_option)+
vimgrep --help
will:
- use ripgrep (`rg`) to grep files
- display the result
- ask for confirmation
- edit the files with vim
You can set the VVV environment variable to
set options for vim:
VVV=-o vimgrep foo
Attention: this will run `rg` twice
usage: vimn file:n
edit file and jump to line 'n'
usage: vimtmp
create a /tmp/foo.XXXXX file and edit it
usage: vimwhich
edits executable that is somewhere in $PATH
or can be located via "locate"
usage: vimx [params] file
create and edit executable bash script
that has a --help command
usage: vimx [params] file
create and edit executable bash script under ~/bin
usage: wait_for_ssh HOST [PORT]
wait_for_ssh --help
Loops trying to connect via ssh until it succeeds
usage: wake-sleep-log
wake-sleep-log --help
searches /var/log/kern.log for power management events
and displays a list when the machine went to slee and
woke up again
usage: whois_ip IP
whois_ip --help
will do a DNS lookup and a whois lookup on an IP
and filter out the relevant fields. Used as a
help tool to manually drop spammer IPs and
networks into a firewall
usage: window (kill|sleep|wake|minimize|pid|pgid) ...
window --help
lets you visually select a window and then
depending on the commands given:
kill: will send SIGTERM and then SIGKILL to
the process group
sleep: will send SIGSTOP to the process group
wake: will send SIGCONT to the process group
minimize: will minimize the window (into the
dock or toolbar or such)
pid: will list the PID of the process
pgid: will list the group ID of the process
pressing ESC while in selection mode will
abort the action
This tool depends on `xdotool`
usage: window.gui [--help]
`window.gui` is a graphical UI for the `window` command.
It will allow you to to minimize a window, suspend it etc.
It's useful for inclusion in a desktop menu, where it lets
you manipulate other windows, in particular suspend
CPU hungry applications, such as browsers.
This application requires the `timeout_pg` command.
usage: wping [URL]
retrieves website via HTTP in order to see whether the web/internet
works. Default site is http://sourcepole.ch
usage: cat foo.yml | yaml2json
yaml2json --help'
transforms YAML to JSON
usage: youtube ["youtube query"|URL]
youtube --help
Access youtube via `google-wrapper`
Depends on `google-wrapper`
usage: zuletzt
zuletzt --help
'zuletzt' means 'last time' in German. It will
play the next multimedia file.
Do create a file ZULETZT which contains:
1600_##.mp3
0
Then call `zuletzt` and it will play the
file 1600_01.mp3 and increase the '0' to '1'
after having successfully played the file with
mpv.