2024-03-06-004525_1920x1080_daisy-noize_snip_trim_yuv420p__panel_showcase.mp4
# Official repos (Arch):
bash
# AUR:
picom-ftlabs-git
# Official repos (Arch):
geoclue2
# AUR:
expect playerctl
To install all of the above (on Arch) run:
sudo pacman -S bash geoclue2
yay -S picom-ftlabs-git expect playerctl
I'm working on a setup script. You can clone the repo for now and manually move things where they belong.
Something like
git clone https://github.com/cherrynoize/dotfiles
cd dotfiles
./.github/install.sh
should work. The installation script is still a stub, and you'll also need to move things where they belong:
mv -n * ~
mv -n .* ~
Note the -n (no-clobber) flag, meaning existing files won't
be replaced and you should manually take care of that.
From now on you can just run:
cfg pull
and it should automatically update your dotfiles. (Please, take care of your own unstaged changes.)
You need to source ~/.initrc during startup. It provides
configuration used all over the place. To do this you can add
something like:
[ -f ~/.initrc ] && . ~/.initrc
to your ~/.xinitrc, ~/.xprofile. You can just execute it
from your WM if you're on Wayland.
To set environmental variables used throughout the dotfiles,
add to your ~/.profile:
[ -f ~/.env ] && . ~/.env
And make sure your display manager sources ~/.profile for
Wayland sessions. You can add the line above in any other file
sourced at login.
This config uses theme
which in turn uses wpgtk
for easier global theming and automatic colorscheme generation
with pywal.
For better portability template symlinks are not hardcoded
and can be regenerated anytime using fix-wpg-templates.
This is automatically run in the installation script.
You can also add your own templates as you regularly would (please refer to the Wpgtk wiki).
You might want to place your own profile picture inside of
~/.pfp. It can be any picture file with any name, such as
~/.pfp/pfp.jpg.
The nvim configuration is based upon
AstroNvim,
an IDE layer for Neovim. Check out the
docs
for info about configuration.
The repo also includes a large collection of shell scripts, some
collected around the internet, but most of
them actually mine. Being each few hundreds LOC tops,
they're not very large (bin sits at 492K at the time of
writing - Nov. 16 2023), and since they're heavily integrated
into most of the config it made little sense leaving them out.
Active development is currently only on fish. bash is
currently my login shell, so the .bashrc is maintained but in
a basic sense.
Please, refer to the theme documentation for usage.
⚠ Please do not run binaries or use shell aliases unless you understand what they do. Take the time to inspect the code first.
You can find all binary files in ~/bin and ~/.local/bin,
shell aliases in ~/.config/fish/config.fish and keyboard
shortcuts in ~/.config/sxhkd/sxhkdrc or
~/.config/hypr/keybindings.conf. Here I try to use a somewhat
sxhkd-inspired syntax for defining keybindings as I find it more
concise. Compiling an extensive shortcuts/commands help is in the
TODO list.
This is just some basic keybindings to get you started.
"$TERMINAL" # Mod+Return
rofi -show drun # Mod+x
rofi -show run # Mod+r
powermenu # Mod+q
theme-picker # Mod+Space
wall-picker # Mod+Ctrl+Space
change-wallpaper # Mod+Ctrl+w
switch-mode # Mod+<
dock toggle # Mod+z
"$BROWSER" # Mod+Alt+w
unfuck everything # Mod+Shift+Esc
launch-nvim # 'nvim' is an alias for that in fish/bash
{Alt,Shift}+Tab Move to next/previous tab
Space;{Shift}+Tab Move to next/previous buffer
Alt+{h,j,k,l} Move to adjacent window
Ctrl+{h,j,k,l} Move to adjacent window (wraparound)
Ctrl+{Left,Up,Down,Right} Resize window
Space Help menu
{Tab,Shift}+Tab Move to next/previous entry
h,j,k,l Vi-like keybindings for moving around (with no inputbar)
Alt+{h,j,k,l} Where there's also an inputbar
sudo privilege timeout for the shell is refreshed with sudo -v. fish already has an abbreviation set
to replace sudo with sudo -v; sudo so that it gets updated
each time. However, I find that cumbersome as well as annoying
to have that prefix to each command and it doesn't work well
with auto-completion/suggestions as well as with other
abbreviations, so you can call sd rather than sudo
to avoid all that. (Also, in case you're wondering, you cannot
use a function because that would enter an infinite loop.)
In case it conflicts with other programs in your system, just use
sudo.
Some text visibility issues in light mode. (Inherited from theme)
-
Widget windows closers sometimes get stuck open, causing you to accidentally open popup windows when clicking on other windows rather than close them. To fix this you could restart
eww, but usually it's enough to click on the pfp icon that open the panel window once to open it, then a second time to close it. -
On bspwm
ewwtends to get on top of other windows after being restarted during the session. I still haven't found how I could prevent it from happening (all suggestions are welcome).
My workaround for the time being is to just toggle the bar. Besides, if you don't ever toggle it this shouldn't come up.
I currently use Spotify and as such I only set music
to fetch cover arts from Spotify metadata. I will try to expand
on this but, please, if anyone has a specific request provide me
with a metadata sample (output of playerctl --player="$player" metadata mpris:artUrl) and I'll add it.
In case something's not working as expected:
unfuck everything
This might help. If it doesn't, you'll have to identify the issue and actually do something about it. (You can have a look at the known bugs.) If you find something that doesn't fit, please open an issue.
- Installation script
- Finish initrc
- Fix bar auto closing on resume after sleep
- Shortcuts/commands usage popup window
You can have a look at the TODO and known bugs lists. Or open a PR/issue if you have found more.
If you feel like you have something to add please do.
Bye!