Man1 - dmscripts.1

Table of Contents

NAME

dmscripts - a collection of various dmenu scripts

DESCRIPTION

dmscripts are a collection of dmenu scripts written in bash. each script is written and contributed by DT or viewers.

USAGE

bash dm-hub

Runs the dm-hub program which allows for easy access to the scripts.

bash path/to/script

Runs the script specified without using dmhub.

./path/to/script

Same as bash path/to/script.

SCRIPTS

dm-hub

The hub script, allows easy access to other scripts.

dm-man

A manual page searcher, search a man page or randomly view one.

dm-colpick

Find the hex value of a color you are searching for.

dm-confedit

A configuration manager, find and edit any config file you need.

dm-currencies

Convert prices between currencies.

dm-ip

Get IP of interface or external IP

dm-kill

Simple process killer, find and kill misbehaving processes.

dm-logout

Simple logout menu, choose to lock, shutdown, reboot or logout of your computer.

dm-music

Dmenu based music player.

dm-note

Store multiple one-line texts or codes and copy one of them when needed.

dm-bookman

A bookmark searching tool, search through all qutebrowser quickmarks and bookmarks.

dm-record

Records audio, video and webcam.

dm-reddit

A reddit viewer using dmenu, still a work in progress.

dm-maim

A GUI to maim using dmenu.

dm-websearch

Web searching utility using dmenu.

dm-weather

Simple graphical weather app

dm-sounds

Choose an ambient background sound to play.

dm-translate

Translate using Google Translate (through Lingva Translate)

dm-usbmount

USB mounting done suckless, no need for bloated daemons.

dm-setbg

Using dmenu, setup a wallpaper.

dm-wifi

Connect to wifi using dmenu.

dm-youtube

Youtube subscriptions without an account or the API tying you down.

dm-helper.sh

Helper scripts adding functionality to other scripts

CONFIG FILES

/etc/dmscripts/config

This is considered the official global config file and we do not recommend you editing it. It will be overwritten if we change the configuration so you’ll need to back it up if you modify it

~/.config/dmscripts/config

The first local config file is found here, this is free to modify and it is the recommended way to change the config file as it does not get overwritten. It is worth noting however that the config is still regularly modified so you will have to keep up to date on our gitlab page and read the diffs.

Using the repo configuration

The repo can be used as is and provides a local config file. You can change it but it’s change at your own risk. If you want to update the repo, for example, there may be merge conflicts. And when commiting, we expect a default config unless you are intentionally making changes to fix a bug or make an update and not to simply change something in a way you prefer.

Using global variables

While we don’t recommend it, you can choose to set some variables in other places such as the bashrc or the /etc/profile file.

Modifying the source

Finally, you can modify the source code to add more files to modify or to customize dmscripts to your heart’s content, please report any bugs along the way however. Confirm it on an unmodified version first and read the issues.

CONFIGURATION

DMENU variable

DMENU is the default variable used in dmscripts, we expect all scripts to use DMENU in substitution of the dmenu command as we want our scripts to be accessible without modifying the source code. Currently DMENU is defined in a case statement which is used to define DMENU differently depending on the script.

Other variables

A lot of the other variables are simply program names or directories and are not worth going into further details.

Lists

Some our config is done in a list like format. There are two syntaxes, -A and -a.

-A uses the format of:

variable[name-displayed-in-dmenu]=what-it-actually-means

-a uses:

variable=(

“thing1”

“thing2”

)

AUTHORS

Author: dt

Created: 2022-02-22 Tue 16:44