Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/expandingman/dotfiles

REPO DEPRECATED, go to https://gitlab.com/expandingman/dotfiles
https://github.com/expandingman/dotfiles

Last synced: about 1 year ago
JSON representation

REPO DEPRECATED, go to https://gitlab.com/expandingman/dotfiles

Awesome Lists containing this project

README 

          
# ⛔GITHUB REPO DEPRECATED ⛔

For a

[multitude](https://www.eff.org/deeplinks/2020/11/riaa-abuses-dmca-take-down-popular-tool-downloading-online-video) [of](https://about.gitlab.com/features/) [reasons](https://en.wikipedia.org/wiki/Censorship_of_GitHub)

I have decided to stop using github where possible.  (I will of course continue to be

involved with projects which still reside here.)



Please see my [dotfiles repo on gitlab](https://gitlab.com/ExpandingMan/dotfiles)!



# dotfiles

The intention is to make it pretty easy to reproduce my linux installs with only what is in this repository.



Note that a lot of helpful information on which programs to use can be found at

[privacytools.io](https://www.privacytools.io).



A useful list of applications and plugins with vim-like control bindings can be found at

[Big Pile of Vim-Like](https://vim.reversed.top/).



## Installer

I've made myself a simple installer program in Julia, which can be found in this

repository under `Installer`.  Enter this with `install.sh`.



![installer](Videos/installer.gif)



## Distro

For the most part everything described here should be more-or-less distro agnostic, but it'll probably be easiest on Arch branches.  Currently the one known

major headache on Ubuntu is that on Ubuntu one has to compile `polybar`.  This is a big pain because `polybar` depends on `libxcb` and in the Ubuntu repos that

library is split into about a billion different packages, so you'll be spending a good amount of time figuring out which ones you need.



## Prompt

I use [prezto](https://github.com/sorin-ionescu/prezto) which runs on `zsh`.  It has lots of useful features, is easy to configure and actually reasonably fast.

Note that tough it must be loaded in `.zshrc` there is separate configuration in `.zpreztorc`.



## Applications

Here is a list of some useful applications that I would like to remember exist



### [`alacritty`](https://github.com/alacritty/alacritty)

The ultimate terminal emulator.  Highly configurable, GPU enabled and written in Rust.

See the `.config/alacritty/alacritty.yml` config.



### [`qutebrowser`](https://wiki.archlinux.org/index.php/Qutebrowser)

A vim-like browser.  Configuration for it in this repo.  The major disadvantage is of

course the lack of add-ons.  Note that I have switched entirely from `qutebrowser` to

Firefox+tridactyl because I could no longer survive without the Firefox add-on ecosystem.



### `arandr`

This is pretty crucial for `i3`.  `arandr` is a simple GUI that lets you arrange the layout of your display output and change resolutions.  `arandr` works by

generating a 1-line script containing the necessary `xrandr` command.  To make this script execute whenever `i3` starts you can just put a line in your

`config`.



### [`rofi`](https://github.com/davatorium/rofi)

This is for launching applications and terminal sessions.



### [`autorandr`](https://github.com/phillipberndt/autorandr)

This can detect your display configuration and apply saved settings.  It is also useful for manually saving profiles.



### `compton`

This is a window compositor that runs in window managers such as `i3`. It needs to be launched during `i3` init (see `i3` conf).  There are settings in the

`compton.conf` that disable the transparency of tabs (so you don't see through to all your tabs) but this will only work in `i3-gaps`.



### [`ranger`](https://wiki.archlinux.org/index.php/Ranger)

This is a simple file browser a bit like from the DOS days.  The main usefulness of this is that you can use it to preview all sorts of things including images

right in the terminal.  Note that you should use the config files found in this repo, and you may need `w3m` installed for previews to work.



### `nmcli`

This is a command line interface for the network manager.  Note also that `nmtui` opens a little DOS-like menu that lets you open connections to new wifi

networks.  Typically I will use `nmcli` to manage my wifi, e.g. `nmcli connection up tristero5`.



### `inxi`

This is a very useful tool for telling you about your hardware configuration.  For example, `inxi -G` tells you about your graphics setup.



### `sensors`

Just what it sounds like, shows output of system sensors.  Gives temperatures and fan speeds where available.



### `scrot`

This is a nice utility for taking screenshots.  Note that my `i3` keybindings for this by default are `Print` for taking a full screenshot, `$mod+Print` for

just the current window, and `Shift+Print` for a little box that you can select with the mouse.  The output will be put in `~/Pictures/screenshots`.



### `amixer`

This is for controlling audio output, usually the OS will use this by default.  I need to make keybindings within `i3` at some point. In the meantime, you can

increase or decrease volume with `amixer set Master x%±`.



### `alsamixer`

This is a TUI for controlling audio devices.  Best way to control volumes of individual devices such as headphones and mics.  See also `pavucontrol` for a full

GUI, sometimes it's easier for things like USB headsets.



### [`mpv`](https://wiki.archlinux.org/index.php/Mpv)

A really nice minimalistic media player.



### `pacui`

An amazing little `pacman` utility for browsing things like dependency trees, file locations and config files.  Also see `pacli`.



### `mps-youtube`

Binary called `mpsyt`, this is a nice way of browsing YouTube from the command line and watching videos with VLC, mpv or another player.



### `zathura`

Vim-like PDF viewer.  On Arch, be sure to install `zathura-pdf-mupdf`.



### `neomutt`

See hideous website [here](https://neomutt.org/).  This is a vim-like mail client I'm considering setting up.



### [`bpytop`](https://github.com/aristocratos/bpytop)

This is the coolest version of `top` that I've seen.  It even has the dracula theme

built-in.  Get it with `pip install bpytop`.



### [`kmon`](https://github.com/orhun/kmon)

A TUI kernel monitor.  This is really useful because it shows a lot of stuff which is

otherwise hard to find.



### Required

The following are required for my default setup

- `i3-gaps` (equivalently `i3` should work just fine) ([here](https://gist.github.com/boreycutts/6417980039760d9d9dac0dd2148d4783) is a brief guide for

    installing on Debian)

- `polybar`

- `rofi`

- `feh`

- `autorandr`

- `ttf-font-awesome` (these are icon fonts used by the `polybar`)

- `nvim` (my default editor I use for everything)



## Directory Structure

Currently the only non-standard directories that will be expected by something are

- `~/Pictures/backgrounds/` (by `feh` for backgrounds)

- `~/Pictures/screenshots/` (by `scrot` for screenshots)



## Colors and Appearance

Currently I'm using the [dracula](https://github.com/dracula/dracula-theme) everywhere mostly because it's *unbelievably well-supported* and, unlike many color

schemes, actually has good enough contrast for me to be happy with it in vim.  I'd basically describe it as "neon that doesn't look too 80's".  The dracula

colors are currently hard-coded into my `init.vim` (via the `dracula.vim` package), `i3/config` and `polybar/config`, which is certainly not ideal.  The only

place a user would need to change the colors manually is on the terminal itself.  I use

the `alacritty` terminal, so terminal colors are defined in

`~/.config/alacritty/alacritty.yml`.



See this [useful color configurator](https://thomashunter.name/i3-configurator/) for `i3`.



### Backgrounds

It is expected that you keep your backgrounds in `$HOME/Pictures/backgrounds`.  The `.fehbg` will randomly assign them when the session starts (called by `i3`).

I like to use a huge number of different backgrounds, the only rule is that they all be somehow "sci-fi" themed (especially spaceships!).



### Fonts

[Hack](https://github.com/source-foundry/Hack).  Should have good unicode support, but the

way fonts get patched seems to work out much better in Arch than Debian.

- Arch Package: `ttf-hack`

- Debian Package: `fonts-hack`



### Future Plans

The current situation with the colors is highly unsatisfactory.  There are some nice tools for assigning colors using images as references using clustering of

the pixels such as [pywal](https://github.com/dylanarapas/pywal) but frankly the results don't often look very nice, especially for doing real work.  At some

point I'm going to carefully create my own color scheme (I've found that this is much harder than it sounds).  I will fork the aforementioned dracula repos and

insert my colors.  Hopefully I will come up with some way to clean up the process a bit when I do so.



My new colors will probably be some sort of bluish thing with cyan and orange highlights.



## Manjaro `i3` Dotfiles

The dot files for the Manjaro `i3` community setup can be found

[here](https://gitlab.manjaro.org/profiles-and-settings/desktop-settings/tree/master/community/i3/skel).  This is probably a good starting point for a great

many things.  More generally, default Manjaro desktop settings can be found at https://gitlab.manjaro.org/profiles-and_settings/desktop-settings .



## Julia

I use [Julia](https://julialang.org) extensively, in the long run I expect it to be much more intimately intertwined with this setup.  Note that for now the

Julia binaries are expected to be in `/opt/julia/bin` (at some point I will have more permanent system-wide environment variables).  You can use `$mod+F1` to

launch a new Julia REPL.



## Web

Slowly mankind frees itself from the oppressive Tyranny of Google.  A few programs are

available which turns some of their own tactics (i.e. aggregation) against them:

- [Invidious](https://invidio.us) ([repo](https://github.com/omarroth/invidious)) is an

    alternative front-end to YouTube.

- [Nitter](https://nitter.net) is an alternative front-end to Twitter (I despise twitter,

    but sometimes interesting people post useful things there).

- [Invidation](https://addons.mozilla.org/en-US/firefox/addon/invidition/) is a Firefox

    plugin for re-directing YouTube and twitter links to invidious and nitter.  (Note that

    by default this also passes lots of parameters in the URL that will override your

    invidious settings, but these can be disabled in settings.)



### Firefox Add-Ons

- [Privacy Badger](https://addons.mozilla.org/en-US/firefox/addon/privacy-badger17/):

    Tracking blocker from EFF.

- [uBlock Origin](https://addons.mozilla.org/en-US/firefox/addon/ublock-origin/): The best

    ad blocker.

- [Invidition](https://addons.mozilla.org/en-US/firefox/addon/invidition/): Plugin for

    re-directing YouTube and twitter links to invidious and nitter (mentioned above).

- [CanvasBlocker](https://addons.mozilla.org/en-US/firefox/addon/canvasblocker/): Plugin

    for blocking some fingerprinting.

- [User-Agent Switcher](https://addons.mozilla.org/en-US/firefox/addon/uaswitcher/):

    Plugin for managing user agent strings.

- [LessPass](https://addons.mozilla.org/en-US/firefox/addon/lesspass/): Stateless password

    generation.

- [Tridactyl](https://addons.mozilla.org/en-US/firefox/addon/tridactyl-vim/): Vim-like

    functionality in firefox.  Almost on-par with qutebrowser, but is a bit fragile.

    Configs are found in this repo.



## How-To

Here is a list of useful things that I often forget how to do:



### Useful Linux Stuff

- [Beej's Guide to Unix IPC](https://beej.us/guide/bgipc/html/single/bgipc.html)

- [Beej's Guide to Network Programming](https://beej.us/guide/bgnet/)

- [GNU on

    Pipes](https://www.gnu.org/software/libc/manual/html_node/Pipes-and-FIFOs.html#Pipes-and-FIFOs)

- [GNU on

    Sockets](https://www.gnu.org/software/libc/manual/html_node/Sockets.html#Sockets)



### Screen and Power Management

- `xset s $NSECONDS`: Sets the timer for the screen to be deactivated to `$NSECONDS`.



### Disks

- `sudo fdisk -l`: Lists mounted disk volumes.  Useful for finding, for example USB flash drives.

- `dd bs=4M if=name_of_iso_file.iso of=/dev/sdX`: Write an ISO file to the drive at `/dev/sdX`.  (Unmount drive with `umount` first.)



### Libraries

- `ldconfig -p`: Lists all libraries in library paths. For example do `ldconfig -p | grep libsdl` to find SDL libraries.

- `ldd`: Lists all the libraries that the binary links to.

- `objdump -p`: Lists all libraries that a binary links to among other things. Note you can also do `ldd` but this may result in code execution.



### Display Servers

- You can start a new X windows session from one of the other terminals (i.e.

    `ctrl-alt-Fn` by doing `startx` from that terminal.

- Wayland is actually a protocol that's implemented by the desktop environments, so there

    is no equivalent to `startx`.  You can try running it from e.g. GNOME by doing

    `gnome-session --session gnome-wayland`.