https://github.com/oncomouse/dotfiles

https://github.com/oncomouse/dotfiles

Last synced: 14 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/oncomouse/dotfiles
• Owner: oncomouse
• Created: 2019-05-29T16:32:52.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2024-04-17T21:07:12.000Z (7 months ago)
• Last Synced: 2024-08-01T19:38:34.110Z (3 months ago)
• Language: Lua
• Size: 27.4 MB
• Stars: 13
• Watchers: 3
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: Readme.md

Awesome Lists containing this project

README

        
# oncomouse Dotfiles

These dotfiles work for Mac OS, Arch, and Ubuntu. Ubuntu can also run for server or desktop configurations. Arch server configuration is on the todo list.

## Usage

Run `git clone https://github.com/oncomouse/dotfiles ~/dotfiles` on your computer. Then run either `make desktop` or `make server` to install. `make` can also be re-run to update software.

## Structure

The organization is as follows:

* `~/dotfiles/stow` -- Configuration files that should be stowed. This is the majority of the actual "dot" file in this dotfiles repository

* `~/dotfiles/conf` -- Configuration files that do not need to be stowed. This is primarily used by files that need to be included into other configurations, where having a stable location, inside the dotfiles repository, is preferable. It was included to manage my (extremely complicated) Vim/Neovim configuration.

* `~/dotfiles/scripts` -- Executables used in these configurations. This includes my implementation of [GNU Stow](https://www.gnu.org/software/stow/), but also things like the powermenu, a wrapper for PyWal, and more.

* `~/dotfiles/bootstrap` -- Scripts used to install and configure the software used in these 

* `~/dotfiles/notes` -- Things I'm always forgetting when installing systems (mostly Arch).

## Stow

Packages are managed with a custom re-write of [GNU Stow](https://www.gnu.org/software/stow/). It's located in `scripts/stow.py`. The re-write implements all features of stow except: `--adopt`, `--ignore`, `--defer`, `--override`, and `--compat`. Also, importantly, it fixes [#33](https://github.com/aspiers/stow/issues/33), which has been documented since Apr 8, 2019 and fixed since May 24, 2020, but continues to be unpatched in stow.