As part of this dotfiles installation, we provide a curated collection of utility scripts that help automate and enhance your desktop experience. These scripts handle everything from brightness control to network checks, and they’re neatly organized under a single command: dots.

dots is a wrapper utility that exposes various helpful scripts for configuring modules and interacting with your system.

You can use it directly from the terminal to:

• Run scripts individually
• Discover available helpers
• Simplify your workflow

dots --help     # Show help menu
dots --list     # List all available scripts
dots <script>   # Run a specific script (with optional flags)

🔍 Pro Tip: You can use chezmoi edit ~/.local/bin/dots to customize the wrapper script if needed.

📝 This list may evolve. To check the current list on your system, run: dots --list

• brightness – Adjust screen brightness via xbacklight, brightnessctl, blight, or xrandr
• check-network – Check if you’re connected to the internet
• checkupdates – Query available package updates
• config-manager – Manage configuration snapshots and backups
• dependencies – Check and install required system dependencies
• feh-blur – Blur the background when using feh to set wallpaper
• git-notify – Send notifications when git commits are made
• gtk-theme – [NEW] Intelligent GTK theme management with rice integration and auto-detection
• i3-resurrect-rofi – Manage i3-resurrect workspace profiles via Rofi menu
• jgmenu – Launch jgmenu application launcher
• microphone – Monitor and toggle microphone mute status with visual indicators
• monitor – Get the name of the currently active monitor
• next-workspace – Switch to the next existing i3 workspace
• night-mode – Toggle night mode/blue light filter
• performance – Monitor system performance and run benchmarks
• popup-calendar – Display a calendar in a popup window
• rofi-bluetooth – Manage Bluetooth device connections via Rofi menu
• rofi-randr – Display resolution management via Rofi menu
• rofi-rice-selector – Select and apply desktop rice themes via Rofi menu
• rofi-run – Enhanced Rofi application and command launcher
• rofi-xrandr – Advanced display configuration with charts via Rofi
• screenshooter – Take screenshots with various options and formats
• scripts – Interactive menu to browse and launch available dots scripts
• security-audit – Run comprehensive security audits and apply security fixes
• smart-colors – [NEW] Analyze color palettes and suggest optimal semantic colors
• sysupdate – Perform comprehensive system updates
• toggle – Toggle state of applications like polybar, compositor, notifications
• updates – Check and display available package updates with notifications
• wal-reload – [ENHANCED] Reload pywal colorscheme and apply smart colors to i3, rofi, eww, polybar, betterlockscreen
• weather-info – Display current weather information and forecasts

Purpose: Intelligent color palette analysis and theme-adaptive color selection.

Usage Examples:

# Quick palette analysis
dots-smart-colors

# Detailed analysis with recommendations
dots-smart-colors --analyze

# Get specific semantic color
dots-smart-colors --concept=error
dots-smart-colors --concept=success --format=polybar

# Export for different applications
dots-smart-colors --export                    # Shell variables
dots-smart-colors --export --format=eww       # EWW SCSS
dots-smart-colors --export --format=i3        # i3 configuration

Key Features:

• 🆕 Light/Dark Theme Detection: Automatically detects theme brightness and optimizes colors accordingly
• 🆕 Smart Foreground Optimization: Light themes get softer foreground colors for better readability
• Theme-adaptive: Colors automatically adjust to any palette
• Semantic mapping: Intelligent error/success/warning color selection
• Multiple formats: Shell, Polybar, EWW, i3 export support
• Fallback system: Always provides valid colors
• Simple variables: Clean COLORERROR, COLOR_SUCCESS format (no SMART prefix)

Purpose: Complete theme refresh with smart color integration.

Automatic Integration: When you change wallpapers via wpg, the system now:

1. Generates pywal colors from wallpaper
2. Analyzes palette with smart colors algorithm
3. Applies optimized colors to all applications:
   • EWW: Enhanced colors.scss with semantic variables
   • Polybar: Smart environment variables + auto-restart
   • i3: Generated colors-smart.conf file
   • Scripts: Weather, player, jgmenu with smart colors

No manual configuration needed - everything happens automatically!

Purpose: Intelligent GTK theme management integrated with the rice system.

Core Features:

• 🎨 Rice Integration: Automatically applies GTK themes based on rice configuration
• 🤖 Smart Detection: Analyzes wallpaper brightness to suggest optimal themes
• 🔄 Auto-Application: Integrated with dots-wal-reload for seamless theme switching
• 📋 Theme Management: List, apply, and analyze installed GTK themes

Usage Examples:

# List all installed GTK themes
dots gtk-theme list

# Show current theme
dots gtk-theme current

# Apply specific theme
dots gtk-theme apply Orchis-Dark-Compact

# Auto-detect optimal theme for current wallpaper
dots gtk-theme auto

# Apply GTK theme for specific rice
dots gtk-theme rice space

# Analyze wallpaper and suggest theme
dots gtk-theme detect ~/Pictures/wallpaper.jpg

Automatic Integration: When you switch rice themes or change wallpapers:

1. Rice Configuration: Each rice can specify preferred GTK theme
2. Smart Analysis: System analyzes wallpaper brightness and colors
3. Theme Selection: Automatically chooses light/dark theme variants
4. Live Application: GTK theme updates immediately for all applications

Rice Configuration Support:

# In rice config.sh files:
GTK_THEME="Orchis-Dark-Compact"    # Specific theme
ICON_THEME="Numix-Circle"          # Icon theme
PREFER_DARK_THEME="true"           # Dark preference

# Or use auto-detection:
GTK_THEME="auto"                   # Auto-detect based on wallpaper
PREFER_DARK_THEME="auto"           # Auto-detect light/dark preference

All scripts can be found in your dotfiles repo (usually under ~/.local/bin/). To customize:

chezmoi edit ~/.local/bin/<script-name>
chezmoi apply

You can also add your own scripts and link them via the dots interface for quick access.

• Explore the script source code: chezmoi edit ~/.local/bin/dots
• Join the Dotfiles Discussions

Use the dots utility to take your workflow to the next level. Automate, simplify, and enjoy the full power of your environment! ⚡