https://github.com/callmeechocodes/dotfiles
🚚 There's no place like ~/
https://github.com/callmeechocodes/dotfiles
Last synced: about 1 year ago
JSON representation
🚚 There's no place like ~/
- Host: GitHub
- URL: https://github.com/callmeechocodes/dotfiles
- Owner: CallMeEchoCodes
- License: mpl-2.0
- Created: 2024-01-05T11:02:47.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-02-18T21:57:10.000Z (over 2 years ago)
- Last Synced: 2025-03-26T03:41:47.758Z (about 1 year ago)
- Language: Shell
- Homepage:
- Size: 367 KB
- Stars: 9
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Echo's Dotfiles
> 🏠 There's no place like ~/
[](https://github.com/CallMeEchoCodes/dotfiles/blob/master/LICENSE)
[](https://github.com/CallMeEchoCodes/dotfiles/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22)
## 🔧 Installing
### Dependencies
### Required
**DISCLAIMER:** I made these dotfiles over the course of a few months. I probably forgot something that is required at some point. Please make an issue if that is the case.
| Name | Description | Where/why is it needed? |
| ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | -------------------------------------- |
| [dossier](https://github.com/CallMeEchoCodes/dossier) | A lightweight dotfile bootstrapper! | Installs dotfiles (and maybe more soon)|
| [Hyprland](https://github.com/hyprwm/Hyprland) | A highly customizable dynamic tiling Wayland compositor that doesn't sacrifice on its looks. | Window Manager/Compositor |
| [Inter Font](https://github.com/rsms/inter) | A typeface carefully crafted & designed for computer screens | System Font |
| [eww-tray](https://github.com/ralismark/eww/tree/tray-3) | A standalone widget system that allows you to implement custom widgets (systray fork). | Top Bar |
| [socat](http://www.dest-unreach.org/socat) | Multipurpose relay (SOcket CAT) | Used in the EWW Workspaces script |
| [rofi](https://github.com/davatorium/rofi) | A window switcher, Application launcher and dmenu replacement. | App launcher |
| [dunst](https://dunst-project.org) | A lightweight replacement for the notification daemons provided by most desktop environments. | Notification Daemon |
| [swaybg](https://github.com/swaywm/swaybg) | A wallpaper utility for Wayland compositors. | Wallpaper Daemon |
| [pipewire](https://pipewire.org) | A project that aims to greatly improve handling of audio and video under Linux. | Audio (replaces pulseaudio) |
| [pipewire-pulse](https://pipewire.org) | A relatively small server that converts the PulseAudio native protocol to PipeWire protocol. | Fully replace pulseaudio with pipewire |
| [wireplumber](https://gitlab.freedesktop.org/pipewire/wireplumber) | Session / policy manager implementation for PipeWire | Fix a ton of audio and video stuff |
### Optional
| Name | Description | Where/why is it needed? |
| ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | -------------------------------------- |
| [WezTerm](https://wezfurlong.org/wezterm/) | A powerful cross-platform terminal emulator and multiplexer | Terminal Emulator |
| [XDPH](https://github.com/hyprwm/xdg-desktop-portal-hyprland) | An XDG Desktop Portal backend for Hyprland. | Fixes screensharing |
| [fish](https://fishshell.com/) | A smart and user-friendly command line shell for Linux, macOS, and the rest of the family. | Shell |
| [fisher](https://github.com/jorgebucaran/fisher) | A plugin manager for Fish | Fish plugins |
| [Starship](https://starship.rs) | The minimal, blazing-fast, and infinitely customizable prompt for any shell! | Shell prompt |
| [slurp](https://github.com/emersion/slurp) | Select a region in a Wayland compositor | Screenshot script (1/3) |
| [grim](https://sr.ht/~emersion/grim/) | Grab images from a Wayland compositor. | Screenshot script (2/3) |
| [hyprpicker](https://github.com/hyprwm/hyprpicker) | A wlroots-compatible Wayland color picker that does not suck. | Colorpicker and Screenshot script (3/3)|
| [swaylock](https://github.com/swaywm/swaylock) | A screen locking utility for Wayland compositors. | Screen lock |
| [swayidle](https://github.com/swaywm/swayidle) | Idle management daemon for Wayland. | Auto screen lock |
| [ncmpcpp](https://github.com/ncmpcpp/ncmpcpp) | A featureful ncurses based MPD client. | Music TUI |
| [mopidy](https://mopidy.com/) | An extensible music server written in Python. | Music Player |
| [mopidy-local](https://mopidy.com/ext/local/) | Mopidy extension for playing music from your local music archive. | Music from local files |
| [mopidy-spotify](https://mopidy.com/ext/spotify/) | Mopidy extension for playing music from the Spotify music streaming service. | Music from spotify |
| [mopidy-mpris](https://mopidy.com/ext/mpris/) | Frontend for controlling Mopidy through the MPRIS D-Bus interface. | Music notification script |
### Installation
1. Install all required dependencies
2. Clone this repo into `~/.dotfiles`
```bash
git clone https://github.com/CallMeEchoCodes/dotfiles ~/.dotfiles
```
3. Delete or move any existing configuration files you might have
4. Install the dotfiles
```bash
cd ~/.dotfiles
dossier install
```
5. Edit the settings
I tried not to hardcode personal stuff but it was kinda required in places. I'll note those here:
* `hyprland/settings.conf` contains monitor config and personal settings (explained in comments)
* `eww/scripts/workspaces` contains more monitor config
* `fish/config.fish` currently contains some stuff that requires my personal sysfetch. I'll move that to `personal.fish` soon.
* `fontconfig/fonts.conf` contains fonts to change
* `rofi/theme.rasi` contains another font to change
* `wezterm/wezterm.lua` guess what? more fonts.
* `ncmpcpp/music-notify.sh` music directory
I think thats all of them but I might have missed some and I would recommend just going through everything to tweak it to your preferences. If you find any hardcoded stuff specific to my system make an issue.
6. Run `dbus-run-session Hyprland` from a TTY to open Hyprland!
## Mappings
`MOD1` = SUPER
`MOD2` = SHIFT
* `MOD1` + `1-9` = Change workspace
* `MOD1` + `MOD2` + `1-9` = Move focused window to another workspace
* `MOD1` + `Q` = Close focused window
* `MOD1` + `F` = Fullscreen focused window
* `MOD1` + `V` = Toggle the focused window between floating and not floating
* `MOD1` + `Hold LMB` + `Drag` = Move window
* `MOD1` + `Hold RMB` + `Drag` = Resize window
* `MOD1` + `ENTER` = Open WezTerm
* `MOD1` + `R` = Open rofi
* `MOD1` + `MOD2` + `M` = Exit Hyprland
* `MOD1` + `MOD2` + `S` = Start screenshot (clipping tool)
* `MOD1` + `MOD2` + `C` = Start hyprpicker
* `MOD1` + `MOD2` + `L` = Lock
## Screenshots
