djcev.com

## Dotfiles

My local scripts & configuration files. Installation and management
is done through the makefile FreeBSD.mk or Linux.mk. Files that end
with the (unfortunately ambiguous) ".fix" suffix contain strings like
"xDK0h" that are defined in colordef\*.sh and are replaced/processed
using sed by way of fixcolor.sh.

My Quake 1 and Quake 3 configs are also included here, though there's
probably something wrong with them.

All files (unless explicitly stated otherwise) are made available under
the 2-clause simplified BSD license; see LICENSE for the full text. 

### Environment & Software Choices

My system is, generally speaking, a modern amd64 PC running X windows
on Linux. 1080p (1920x1080) resolution, true color support (even in
the terminal), et cetera. A pretty normal set of hardware in 2024 but
worth calling out. These config files are written for that setup.

I use the X windows programs alacritty, conky, dunst, herbstluftwm,
jgmenu, mpv, picom, redshift, and tint2. Terminal emulator, system monitor,
notification daemon, window manager, menu, video player, compositor,
automated color temperature changer, and panel/taskbar respectively.

On the console I use cmus, irssi, mutt, newsboat, and vim. Music player,
IRC client, mail user agent, RSS reader, and editor respectively.

Nothing too unusual in those lists.

### Themes, Color Choices

I'm currently using the McMojave GTK2/GTK3/Metacity theme available from
<https://github.com/vinceliuice/Mojave-gtk-theme>.

Terminal colors (and the contents of colordef_gruvbox.sh) are gruvbox
by Morhetz, available here <https://github.com/morhetz/gruvbox>.

### Shell Scripts

Most of the shell scripts in this repository are generalized frontends
to various utilities, some with a bit of extra logic in them.

bin/aliases.sh are my shell aliases, nothing fancy. bin/run_tv.sh and
bin/youtube.sh are very basic, not much more than aliases.

bin/back.sh is an X windows background (root image) setter, a frontend for
hsetroot (https://github.com/himdel/hsetroot) capable of selecting random
images from a list or directory.

bin/words.sh is a little tool that randomly selects n words from a file,
default 3 words from /usr/share/bin/words.

bin/xvt.sh runs a new terminal emulator in the current working directory
of the shell running in the currently selected window. It's a bit weird,
doesn't always work.

bin/lc.sh is an ls-like that lists files in a directory and colorizes
the output based on filetype, filesize, and other criteria determined in
a great big case statement. Only tested on FreeBSD. Please don't alias or
otherwise call it as ls, it's a very bad idea.

config/redshift/hooks/background.sh is an automated background selector &
setter launched by redshift (<http://jonls.dk/redshift/>) when the redshift
period (day, transition, night) changes. I use sets of background art from
visual novels that depict scenes at different times of day. The conky
config at config/conky/conky.conf also hooks into this to draw a character
image with appropriate (day, transition, night) tinting and an expression
based on system load average.