{"id":14069773,"url":"https://github.com/nocturnalbeast/dotfiles","last_synced_at":"2025-04-28T15:40:52.475Z","repository":{"id":192828095,"uuid":"145768031","full_name":"nocturnalbeast/dotfiles","owner":"nocturnalbeast","description":"My configuration files and scripts for applications including window managers, terminal applications and more.","archived":false,"fork":false,"pushed_at":"2024-08-27T14:04:25.000Z","size":77991,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2024-08-27T15:36:53.713Z","etag":null,"topics":["bspwm","dotfiles","picom","polybar","scripts","spectrwm","suckless","theming","vim","zsh"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nocturnalbeast.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2018-08-22T22:07:43.000Z","updated_at":"2023-09-17T15:43:26.000Z","dependencies_parsed_at":null,"dependency_job_id":"ce0aa240-0537-4d19-8dee-231141a07fa5","html_url":"https://github.com/nocturnalbeast/dotfiles","commit_stats":null,"previous_names":["nocturnalbeast/dotfiles"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nocturnalbeast%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nocturnalbeast%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nocturnalbeast%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nocturnalbeast%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nocturnalbeast","download_url":"https://codeload.github.com/nocturnalbeast/dotfiles/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227159834,"owners_count":17739968,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bspwm","dotfiles","picom","polybar","scripts","spectrwm","suckless","theming","vim","zsh"],"created_at":"2024-08-13T07:07:12.575Z","updated_at":"2024-11-29T15:48:44.192Z","avatar_url":"https://github.com/nocturnalbeast.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n    \u003cpicture\u003e\n        \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/nocturnalbeast/dotfiles/blob/master/repo_resources/logo-dark.png?raw=true\"\u003e\n      \u003cimg alt=\"logo\" src=\"https://github.com/nocturnalbeast/dotfiles/blob/master/repo_resources/logo-light.png?raw=true\"\u003e\n    \u003c/picture\u003e\n\u003c/div\u003e\n\n## Usage\n\nThese dotfiles are managed with [GNU stow](https://www.gnu.org/software/stow/), so you'll need it installed.\n\nTo install these dotfiles, there is an installer script included. Clone the repository, and run the script `install.sh` to install all available packages.\n\nFor a quick guide for managing and using dotfiles managed with [GNU stow](https://www.gnu.org/software/stow/), I recommend [alexpearce's guide](https://alexpearce.me/2016/02/managing-dotfiles-with-stow/) on the same.\n\n\n## Components\n\n * Desktop:\n    * [bspwm](https://github.com/baskerville/bspwm): A tiling window manager based on binary space partitioning.\n    * [spectrwm](https://github.com/conformal/spectrwm): A small dynamic tiling window manager for X11.\n    * [sxhkd](https://github.com/baskerville/sxhkd): Simple X hotkey daemon\n    * [polybar](https://github.com/polybar/polybar): A fast and easy-to-use status bar.\n    * [dmenu](https://tools.suckless.org/dmenu): Dynamic menu for X.\n        * [clipmenu](https://github.com/cdown/clipmenu): Clipboard management using dmenu.\n    * [picom](https://github.com/yshui/picom): A lightweight compositor for X11.\n    * [dunst](https://github.com/dunst-project/dunst): Lightweight and customizable notification daemon.\n\n * Applications:\n    * [kitty](https://github.com/kovidgoyal/kitty):  Cross-platform, fast, feature-rich, GPU based terminal.\n    * [neovim](https://github.com/neovim/neovim): Vim fork focused on extensibility and usability.\n        * [vim-plug](https://github.com/junegunn/vim-plug): Minimalist vim plugin manager.\n    * [mopidy](https://github.com/mopidy/mopidy): Extensible music server written in Python.\n        * [mopidy-mpd](https://github.com/mopidy/mopidy-mpd): Extension for controlling playback from MPD clients.\n        * [mopidy-soundcloud](https://github.com/mopidy/mopidy-soundcloud): Extension for playing music from SoundCloud.\n        * [mopidy-scrobbler](https://github.com/mopidy/mopidy-scrobbler): Extension for scrobbling played tracks to Last.fm.\n        * [mopidy-spotify](https://github.com/mopidy/mopidy-spotify): Extension for playing music from Spotify.\n        * [mopidy-alsamixer](https://github.com/mopidy/mopidy-alsamixer): Extension for ALSA volume control.\n        * [mopidy-local](https://github.com/mopidy/mopidy-local): Extension for playing music from your local music archive.\n        * [mopidy-youtube](https://github.com/natumbri/mopidy-youtube): Extension for playing music from YouTube.\n        * [mopidy-mpris](https://github.com/mopidy/mopidy-mpris): Extension for controlling Mopidy through the MPRIS D-Bus interface.\n    * [ncmpcpp](https://github.com/ncmpcpp/ncmpcpp): Featureful ncurses based MPD client.\n    * [mpc](https://github.com/MusicPlayerDaemon/mpc): Command-line client for MPD.\n    * [firefox](https://www.mozilla.org/firefox): A free and open-source web browser developed by the Mozilla Foundation.\n    * [xwallpaper](https://github.com/stoeckmann/xwallpaper): Wallpaper setting utility for X.\n    * [newsboat](https://github.com/newsboat/newsboat): An RSS/Atom feed reader for text terminals.\n    * [castero](https://github.com/xgi/castero): TUI podcast client for the terminal.\n    * [bottom](https://github.com/ClementTsang/bottom): Yet another cross-platform graphical process/system monitor.\n    * [cava](https://github.com/karlstav/cava): Console-based Audio Visualizer for Alsa.\n    * [thunar](https://gitlab.xfce.org/xfce/thunar): Modern, fast and easy-to-use file manager for XFCE.\n    * [engrampa](https://github.com/mate-desktop/engrampa): A file archiver for MATE.\n    * [mpv](https://github.com/mpv-player/mpv): A free, open source, and cross-platform media player.\n    * [zathura](https://git.pwmt.org/pwmt/zathura): A highly customizable and functional document viewer.\n    * [pqiv](https://github.com/phillipberndt/pqiv): Powerful image viewer with minimal UI.\n    * [maim](https://github.com/naelstrof/maim): Screenshot utility.\n\n * Shell:\n    * [zsh](http://zsh.sourceforge.net): The Z SHell - designed for interactive use and powerful scripting.\n        * [zinit](https://github.com/zdharma/zinit): Ultra-flexible and fast ZSH plugin manager.\n    * [bash](https://git.savannah.gnu.org/cgit/bash.git): The Bourne Again SHell - the GNU standard shell.\n\n * Shell utilities:\n    * [surfraw](https://gitlab.com/surfraw/Surfraw): Utility to search the web using multiple search engines from the command line.\n    * [ueberzug](https://github.com/seebye/ueberzug): Command line util which allows to draw images on terminals by using child windows.\n    * [vivid](https://github.com/sharkdp/vivid): A generator for LS_COLORS with support for multiple color themes.\n    * [exa](https://github.com/ogham/exa): A modern replacement for ‘ls’.\n    * [bat](https://github.com/sharkdp/bat): A cat(1) clone with wings.\n    * [dtrx](https://github.com/brettcs/dtrx): CLI tool that extracts archives in a number of different formats.\n    * [trash-cli](https://github.com/andreafrancia/trash-cli): Command line interface to the freedesktop.org trashcan.\n    * [ripgrep](https://github.com/BurntSushi/ripgrep): CLI that recursively searches directories for a regex pattern while respecting your gitignore.\n    * [fzf](https://github.com/junegunn/fzf): A command-line fuzzy finder.\n    * [lyricwikia](https://github.com/enricobacis/lyricwikia): Python API to get song lyrics from LyricWikia.\n    * [neofetch](https://github.com/dylanaraps/neofetch): A command-line system information tool written in bash 3.2+.\n    * [bc](http://phodd.net/gnu-bc): A fairly ubiquitous, useful and powerful calculator.\n    * [wmctrl](http://tripie.sweb.cz/utils/wmctrl): Command line tool to interact with an EWMH/NetWM compatible X Window Manager.\n    * [xdotool](https://github.com/jordansissel/xdotool): Fake keyboard/mouse input, window management, and more.\n    * [playerctl](https://github.com/altdesktop/playerctl): MPRIS media player command-line controller.\n    * [youtube-dl](https://github.com/ytdl-org/youtube-dl): Command-line program to download videos from YouTube.com and other video sites.\n\n * Appearance-related resources:\n    * Shell prompt:\n        * [Starship](https://github.com/starship/starship): The minimal, blazing-fast, and infinitely customizable prompt for any shell!\n    * Fonts:\n        * [Iosevka](https://github.com/be5invis/Iosevka): Slender typeface for code, from code.\n        * [nerd-fonts](https://github.com/ryanoasis/nerd-fonts): Iconic font aggregator, collection, \u0026 patcher.\n    * Themes:\n        * [bnw](https://github.com/nocturnalbeast/dotfiles/tree/master/gtk/.themes/bnw): My personal theme (made with [themix](https://github.com/themix-project)). High contrast, and as dark as possible!\n    * Cursors:\n        * [Bibata](https://github.com/ful1e5/Bibata_Cursor): Material based cursors.\n    * Icons:\n        * [papirus-bnw](https://github.com/nocturnalbeast/dotfiles/tree/master/gtk/.icons/oomox-bnw): A variant of [Papirus](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme) made with [themix](https://github.com/themix-project) to compliment the main theme.\n    * Wallpapers:\n        * All wallpapers are obtained from [wallhaven](https://wallhaven.cc).\n\n\n## Keybinding layout\n\nAll the global keybindings use the `Super/Win` key as the main modifier.\nYou can use these layout diagrams to familiarize yourself with the key bindings, or you can customize them to fit your liking!\n\n#### Tiling WM keybindings\n\n\u003cimg align=\"center\" src=\"https://github.com/nocturnalbeast/dotfiles/blob/master/repo_resources/key_layouts/images/tiling.png?raw=true\" alt=\"tiling-layout\"\u003e\n\n## Screenshots\n\n * Default desktop - clean\n\n   (to be added)\n\n * Default desktop - floating window with alternate bar\n\n   (to be added)\n\n * Default desktop - busy\n\n   (to be added)\n\n * Menu interaction\n\n   (to be added)\n\n * Sample GTK application (file manager)\n\n   (to be added)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnocturnalbeast%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnocturnalbeast%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnocturnalbeast%2Fdotfiles/lists"}