Skip to content
blxshell

Quick Start

Installation (2 minutes)

Section titled “Installation (2 minutes)”
Terminal window
bash <(curl -fsSL https://raw.githubusercontent.com/binarylinuxx/dots/main/install.sh)

Follow the prompts and logout when complete.

First Login (1 minute)

Section titled “First Login (1 minute)”
  1. Select Hyprland from your login manager
  2. Login with your credentials
  3. Wait for Quickshell to load (~5 seconds)

You should see the bar appear at the top with workspaces, system tray, and clock.

Essential Keybindings (2 minutes)

Section titled “Essential Keybindings (2 minutes)”

Most Important

Section titled “Most Important”
KeybindAction
Super + ReturnOpen terminal
Super + QClose window
Super + SpaceOpen launcher
Super + SOpen settings
Super + WChange wallpaper

Workspaces

Section titled “Workspaces”
KeybindAction
Super + 1-9Switch to workspace 1-9
Super + Shift + 1-9Move window to workspace
Super + Mouse WheelCycle workspaces

Window Management

Section titled “Window Management”
KeybindAction
Super + TToggle floating
Super + Arrow KeysMove focus
Super + Mouse DragMove window
Super + Right MouseResize window

See all keybindings →

Try It Out

Section titled “Try It Out”

1. Open Terminal

Section titled “1. Open Terminal”

Press Super + Return

/usr/bin/fish
# Check your shell
echo $SHELL
# Check theme colors
cat ~/.config/hypr/colors.conf

2. Open Launcher

Section titled “2. Open Launcher”

Press Super + Space

  • Type to search applications
  • Use arrow keys to navigate
  • Press Enter to launch

3. Change Wallpaper

Section titled “3. Change Wallpaper”

Press Super + W

Your colors will automatically update to match the new wallpaper!

4. Open Settings

Section titled “4. Open Settings”

Press Super + S

Configure:

  • Bar appearance
  • Launcher behavior
  • Workspace settings
  • Visual effects

Customize Your Setup

Section titled “Customize Your Setup”

Change Colors

Section titled “Change Colors”

Colors are generated from your wallpaper:

Terminal window
# Use any image
matugen image /path/to/wallpaper.png


# Or use a specific color
matugen color "#FF5733"

Change Fonts

Section titled “Change Fonts”

Edit ~/.config/quickshell/config.json:

{
  "fontFamily": "Your Font Name",
  "fontSize": 14
}

Modify Keybindings

Section titled “Modify Keybindings”

Edit ~/.config/hypr/keyboard/binds.conf:

# Add your custom binds
bind = $mainMod, X, exec, your-command

Next Steps

Section titled “Next Steps”

settings Configure Hyprland

widgets Customize Quickshell

palette Theme Your Desktop

Common Tasks

Section titled “Common Tasks”

Take a Screenshot

Section titled “Take a Screenshot”

Press Print Screen

Screenshots are saved to clipboard.

Record Screen

Section titled “Record Screen”
  • Super + N - Start recording
  • Super + E - Stop recording

Videos saved to ~/Videos/ with timestamp

Adjust Volume

Section titled “Adjust Volume”
  • XF86AudioRaiseVolume - Volume up
  • XF86AudioLowerVolume - Volume down
  • XF86AudioMute - Toggle mute

Or click the volume icon in the system tray

Control Media

Section titled “Control Media”
  • XF86AudioPlay - Play/pause
  • XF86AudioNext - Next track
  • XF86AudioPrev - Previous track

Tips & Tricks

Section titled “Tips & Tricks”

Speed Up Animations

Section titled “Speed Up Animations”

Edit ~/.config/hypr/visual/o2-vertical.conf:

animations {
    # Change bezier curves for faster animations
    bezier = workspaceIn, 0.22, 1, 0.36, 1
}

Add More Workspaces

Section titled “Add More Workspaces”

Edit ~/.config/quickshell/config.json:

{
  "workspaceCount": 15,  // Default is 10
  "dynamicWorkspaces": true
}

Change Bar Height

Section titled “Change Bar Height”

Edit ~/.config/quickshell/config.json:

{
  "barHeight": 40,  // Default is 35
  "barRadius": 30
}

Getting Help

Section titled “Getting Help”