Home

Awesome

<div align="center"> <img src=".github/assets/header.svg" width="100%" height="100%" alt="elena's dotfiles banner"> </div> <h1 align="center"> <a href="#setup">Setup</a> ･ <a href="https://github.com/elenapan/dotfiles/wiki">Wiki</a> ･ <a href="https://github.com/elenapan/dotfiles/wiki/Gallery">Gallery</a> ･ <a href="#tip-jar">Tip Jar</a> </h1> <br>

Thanks for dropping by!

<img src="https://raw.githubusercontent.com/wiki/elenapan/dotfiles/assets/aphelion.png" alt="img" align="right" width="400px">

This is my personal collection of configuration files that forms the desktop you see on the right.

Here are some details about my current setup:

<br> <br>

Philosophy

This is not a traditional desktop in any sense. It is highly opinionated, consists of what works for me and looks good for me and frequently disregards traditional desktop conventions and expectations. It has been evolving for about 8 years, spanning across several window managers and a migration from X11 to Wayland.

This desktop is:

Latest iteration: Aphelion

Features:

All interactive widgets can be controlled both with the mouse and the keyboard.

<h3> <a href="https://www.youtube.com/watch?v=IrF-VVKKK7o"><tt>🎬 45 second showcase (YouTube)</tt></a> </h3>

Setup

  1. Install dependencies

    The following packages need to be installed for all desktop functionality to work.

    PackagePurpose
    swayfxWindow manager / compositor
    i3ipcSway-related scripts
    ewwWidgets
    bashVarious scripts
    pythonVarious scripts
    rofi-waylandLaunchers and menus
    dunstNotification daemon
    libnotifyNotification creation with notify-send
    notify-send.shnotify-send wrapper for notification replacement
    jqjson parsing in various scripts
    inotify-toolsReaction to file changes in various scripts
    lightBrightness control
    wgetMaking HTTP requests in various scripts
    acpidBattery charger state information
    pulseaudioSound daemon
    slurpScreen region selection (Wayland)
    grimScreenshot tool (Wayland)
    grimshotgrim and slurp wrapper
    playerctlMedia info
    imagemagickMedia art cropping
    gammastepScreen color temperature tool
    kdeconnectPhone battery information
    kittyTerminal emulator
    iproute2Network events information
    iwdWireless daemon

[!WARNING] iwd: If you already have a different wireless daemon installed, do not install and enable iwd. Having more than one wireless daemon running at the same time might disconnect your current wireless connection or cause other network issues. Note that iwd can be used as a backend for NetworkManager.

[!NOTE] Depending on your distribution, the names of the above packages may slightly differ. Also, some of the packages might not be available in your distribution's repositories so you might have to build them from source.

  1. Install fonts

    The current setup uses the following fonts:

    To save you time hunting for them online, I have uploaded a .zip file to Dropbox. Download the .zip and then:

    # Assuming the .zip was saved in ~/Downloads
unzip -d ~/.local/share/fonts ~/Downloads/elenapan-dotfiles-fonts.zip
fc-cache -v

  2. Install dotfiles

    Backup first:

    mkdir ~/config-backup
cp -r ~/.config/{sway,eww,dunst,fontconfig,kitty,rofi} ~/config-backup

    Then clone the repo and install the relevant dotfiles:

    git clone https://github.com/elenapan/dotfiles
cd dotfiles
cp -r config/{sway,eww,dunst,fontconfig,kitty,rofi} ~/.config

  3. Tweak the last few settings

    • Set wallpaper:

      cp /path/to/your/wallpaper ~/.local/share/wallpaper

    • Set location for the weather information widget:

      Edit ~/.config/eww/scripts/daemons/weather.sh and set the location variable. For example:

      location="Moscow,Russia"

    • Set lockscreen widget password:

      Edit ~/.config/eww/globals.yuck and set the screen-lock-password variable. For example:

      (defvar screen-lock-password "hunter2")

    • Set agenda widget .org files to watch:

      Edit ~/.config/eww/scripts/daemons/agenda.sh and set the org_files variable. For example:

      org_files=("$HOME/notes/todo.org" "$HOME/notes/birthdays.org" "$HOME/notes/finance.org")

Login

To start the desktop, you may follow the steps in the "Starting" section of the Sway article in the Arch Wiki

[!NOTE] SwayFX is essentially Sway with extra features, which means Sway-related and i3-related resources also apply to SwayFX.

Usage

All keybinds are declared in the sway configuration directory in the following files:

Contributing

Tip Jar

If you enjoy using this desktop or parts of it and would like to show your appreciation, you may leave a tip here.

It is never required but always appreciated.

Thank you from the bottom of my heart! 💙

<h3 align="center"> <a href="#----setup-----wiki-----gallery-----tip-jar"><tt>👆 Back to top</tt></a> </h3>