Skip to content

moxer-mmh/dotfiles

Repository files navigation

🌌 Cosmic Space Station Dotfiles

Linux Wayland Theme Status

🚀 A complete cyberpunk-cosmic themed development environment for Linux 🚀

Professional dotfiles featuring cosmos/nebula/cyberpunk space station aesthetics Hyprland • Waybar • Alacritty • Rofi • Starship • Zsh


Features Overview

🎨 Cosmic Visual Identity

  • 🌌 Deep Space Aesthetics: Nebula backgrounds with electric purple → cosmic cyan → neon green gradients
  • ⚡ Neon Cyberpunk Accents: Matrix-inspired green text with hot pink highlights
  • 🔮 Transparency & Blur: Modern depth effects with backdrop blur and layered opacity
  • 🎭 Consistent Iconography: Space station themes across all applications
  • ✨ Smooth Animations: Cosmic bezier curves and space-themed transitions

🖥️ Professional Window Management

  • 🚀 Hyprland Wayland Compositor: GPU-accelerated with cosmic animations
  • 🖼️ Dual Monitor Support: 1920x1080@144Hz + 1280x1024@60Hz optimized setup
  • ⌨️ AZERTY Layout Optimized: French keyboard layout with development-focused shortcuts
  • 🌅 Dynamic Wallpapers: Automatic cosmic wallpaper cycling with smooth transitions
  • 🔒 Intelligent Power Management: Battery-aware idle states and secure lock screen

🎮 Cosmic Control Center

  • 📊 Waybar Status Bar: Space station control panel with system monitoring
  • 🚀 Rofi Application Launcher: Cyberpunk and space station themed menus
  • 🐲 Starship Prompt: Cross-shell cosmic dragon prompt with language detection
  • 📋 Smart Clipboard Manager: Persistent clipboard history with text and image support
  • 🌊 Seamless Integration: All components work together harmoniously

💻 Development Environment

  • ⚡ Alacritty Terminal: High-performance GPU-accelerated with cosmic transparency
  • 🔤 JetBrains Mono Nerd Font: Consistent typography with programming ligatures
  • 🐚 Enhanced Zsh Shell: Oh My Zsh framework with modern CLI tool replacements
  • 🎯 Developer-Focused: Optimized for coding workflows and system administration

Cosmic Color Palette

Component Primary Colors Accent Colors Status Colors
🌌 Space Station Deep Space #0a0a0f Electric Purple #8844ff Success Green #00ff88
⚡ Cyberpunk Dark Navy #1a1a2e Neon Cyan #00bfff Warning Orange #ffa500
🔮 Cosmic Nebula Purple #1e0c44 Hot Pink #ff69b4 Critical Red #ff4500

Visual Harmony

All components share the same cosmic DNA:

  • Background: Deep space blacks with transparency
  • Text: Matrix neon green for optimal readability
  • Accents: Purple-cyan gradients with pink highlights
  • Status: Color-coded feedback for instant recognition

📋 System Requirements

🔧 Core Dependencies

# Arch Linux / Manjaro (recommended)
sudo pacman -S hyprland hypridle hyprlock waybar alacritty rofi starship zsh
sudo pacman -S swww swaync brightnessctl playerctl

# Audio system (PipeWire)
sudo pacman -S pipewire pipewire-pulse pipewire-alsa pavucontrol wireplumber

# Clipboard management
sudo pacman -S cliphist wl-clipboard

# System dependencies
sudo pacman -S ttf-jetbrains-mono-nerd stow git

# Enhanced CLI tools
sudo pacman -S lsd bat neovim oh-my-zsh-git

# Optional development tools
sudo pacman -S code brave-browser spotify-launcher nautilus

📦 Component Versions

  • Hyprland: 0.41+
  • Waybar: 0.9.24+
  • Alacritty: 0.13+
  • Rofi: 1.7+
  • Starship: 1.16+
  • Zsh: 5.8+

🎮 Hardware Recommendations

  • GPU: Support for Wayland compositor (Intel/AMD/NVIDIA)
  • RAM: 8GB+ for smooth animations and multiple monitors
  • Display: Any resolution (optimized for dual monitor setups)

Installation

📥 Method 1: Quick Setup (Recommended)

# 1. Clone the cosmic repository
git clone https://github.com/moxer-mmh/dotfiles.git ~/dotfiles
cd ~/dotfiles

# 2. Install system dependencies (see requirements above)

# 3. Backup existing configurations (safety first!)
mkdir -p ~/.config/backup/$(date +%Y%m%d_%H%M%S)
for app in alacritty hypr rofi starship waybar zsh; do
    [ -d ~/.config/$app ] && cp -r ~/.config/$app ~/.config/backup/$(date +%Y%m%d_%H%M%S)/
done

# 4. Deploy the cosmic configuration
stow alacritty
stow hypr
stow rofi
stow starship
stow waybar
stow zsh

# 5. Make scripts executable
chmod +x ~/.config/hypr/scripts/*.sh
chmod +x ~/.config/waybar/scripts/*.sh

# 6. Launch the space station!
# Log out and select Hyprland from your display manager

📋 Method 2: Selective Installation

Install only specific components:

cd ~/dotfiles

# Essential cosmic components
stow alacritty    # 🚀 Cosmic terminal
stow hypr         # 🌌 Window manager with space station scripts
stow waybar       # 📊 Status bar with cosmic modules

# Enhanced user experience
stow rofi         # 🎮 Application launcher themes
stow starship     # 🐲 Cosmic dragon shell prompt
stow zsh          # 🐚 Enhanced shell with modern tools

🔄 Method 3: Traditional Symlinks

# Manual symlink creation (for advanced users)
ln -sf ~/dotfiles/alacritty/.config/alacritty ~/.config/alacritty
ln -sf ~/dotfiles/hypr/.config/hypr ~/.config/hypr
ln -sf ~/dotfiles/waybar/.config/waybar ~/.config/waybar
ln -sf ~/dotfiles/rofi/.config/rofi ~/.config/rofi
ln -sf ~/dotfiles/starship/.config/starship.toml ~/.config/starship.toml
ln -sf ~/dotfiles/zsh/.zshrc ~/.zshrc

🎯 Component Documentation

Each component has detailed documentation with installation guides, customization options, and troubleshooting:

Component Features Documentation
🚀 Alacritty GPU-accelerated terminal, cosmic transparency, 50% opacity Terminal setup, color schemes, performance tuning
🌌 Hyprland Wayland compositor, dual monitors, AZERTY optimized Window management, animations, scripts, troubleshooting
🎮 Rofi Space Station & Cyberpunk themes, smooth animations Theme comparison, customization, integration guides
🐲 Starship Cosmic dragon prompt, language detection, performance tracking Prompt customization, shell integration, configuration
📊 Waybar Cosmic status bar, system monitoring, audio controls Module configuration, styling, scripts, integration
Zsh Oh My Zsh framework, enhanced CLI tools, aliases Shell setup, productivity features, customization

⚙️ Essential Configuration

🖼️ Wallpaper Setup

# Create wallpaper directory for automatic cycling
mkdir -p ~/Pictures/Wallpapers

# Add your cosmic wallpapers (JPG, JPEG, PNG supported)
# Wallpapers will automatically cycle every 30 seconds

# Test wallpaper system
~/.config/hypr/scripts/wallpaper-cycle.sh

🔤 Font Configuration

# Install JetBrains Mono Nerd Font (required for icons)
wget https://github.com/ryanoasis/nerd-fonts/releases/download/v3.0.2/JetBrainsMono.zip
unzip JetBrainsMono.zip -d ~/.local/share/fonts/
fc-cache -fv

# Verify font installation
fc-list | grep -i jetbrains

🐚 Shell Setup

# Change default shell to Zsh
chsh -s $(which zsh)

# Install Oh My Zsh (if not already installed)
sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

# Start new shell session
exec zsh

🔧 Customization Guide

🎨 Changing Colors

Global color modifications:

# Primary cosmic colors in Waybar
edit ~/.config/waybar/style.css
# Look for: --deep-space, --electric-purple, --neon-cyan

# Terminal colors in Alacritty
edit ~/.config/alacritty/alacritty.toml
# Look for: [colors] section

# Rofi theme colors
edit ~/.config/rofi/space-station.rasi  # or cyberpunk.rasi
# Look for: color definitions at top of file

🌅 Adding Wallpapers

# Add new cosmic wallpapers
cp your-space-wallpapers/* ~/Pictures/Wallpapers/

# Wallpapers will automatically cycle
# To force immediate change:
~/.config/hypr/scripts/wallpaper-cycle.sh

⌨️ Keybinding Modifications

# Edit Hyprland keybindings
edit ~/.config/hypr/hyprland.conf
# Look for: bind = sections

# Common customizations:
# - Change $mainMod (default: Super key)
# - Add application shortcuts
# - Modify workspace navigation

🎭 Theme Switching

# Switch Rofi themes
rofi -show drun -theme ~/.config/rofi/space-station.rasi  # Cosmic theme
rofi -show drun -theme ~/.config/rofi/cyberpunk.rasi     # Cyberpunk theme

# Make permanent by editing Hyprland config:
# bind = $mainMod, Space, exec, rofi -show drun -theme ~/.config/rofi/cyberpunk.rasi

🔗 Integration & Workflow

🚀 Development Workflow

# Quick development session
Super + Enter          # Launch Alacritty terminal
Super + C              # Open VS Code
Super + B              # Launch Brave browser
Super + Space           # Rofi application launcher

# Git workflow (with Oh My Zsh git plugin)
gst                    # git status
gco main               # git checkout main
ga .                   # git add .
gcmsg "commit message" # git commit -m

📊 System Monitoring

# Waybar modules show real-time info:
# - CPU usage with click-to-htop
# - Memory monitoring
# - Battery status with health optimization
# - Audio controls with mute indicators
# - Camera privacy status
# - Network connection state

🎵 Media Controls

# Waybar Spotify integration:
# Left click: Play/pause
# Right click: Next track
# Scroll: Volume control

# Audio controls:
# Click: Open pavucontrol
# Right click: Toggle mute
# Scroll: Adjust volume

📁 Project Structure

dotfiles/
├── 🚀 alacritty/          # Cosmic terminal configuration
│   ├── README.md           # Terminal documentation
│   └── .config/alacritty/
│       └── alacritty.toml  # Color scheme, transparency, font
│
├── 🌌 hypr/               # Hyprland window manager
│   ├── README.md           # WM documentation
│   └── .config/hypr/
│       ├── hyprland.conf   # Main compositor config
│       ├── hyprlock.conf   # Cosmic lock screen
│       ├── hypridle.conf   # Power management
│       └── scripts/        # Space station automation
│           ├── space-station-startup.sh
│           ├── wallpaper-cycle.sh
│           ├── battery-monitor.sh
│           └── camera-toggle.sh
│
├── 🎮 rofi/               # Application launcher themes
│   ├── README.md           # Launcher documentation
│   └── .config/rofi/
│       ├── space-station.rasi    # Cosmic nebula theme
│       └── cyberpunk.rasi        # Neon city theme
│
├── 🐲 starship/           # Cross-shell cosmic prompt
│   ├── README.md           # Prompt documentation
│   └── .config/
│       └── starship.toml   # Dragon prompt configuration
│
├── 📊 waybar/             # Space station status bar
│   ├── README.md           # Status bar documentation
│   └── .config/waybar/
│       ├── config.jsonc    # Module configuration
│       ├── style.css       # Cosmic styling
│       └── scripts/
│           └── camera.sh   # Camera privacy monitoring
│
├── 🐚 zsh/                # Enhanced shell configuration
│   ├── README.md           # Shell documentation
│   └── .zshrc              # Zsh configuration with aliases
│
├── 📄 README.md            # This cosmic guide
├── 📄 LICENSE              # MIT License
└── 📄 Makefile             # Automation scripts

🐛 Troubleshooting

🔧 Common Issues

Hyprland won't start:

# Check logs for errors
journalctl --user -u hyprland

# Verify dependencies
hyprland --version
waybar --version

Missing icons/fonts:

# Reinstall Nerd Fonts
sudo pacman -S ttf-jetbrains-mono-nerd
fc-cache -fv

# Verify font installation
fc-list | grep -i nerd

Waybar not displaying:

# Check configuration syntax
waybar --log-level debug

# Test individual modules
~/.config/waybar/scripts/camera.sh

Rofi themes not working:

# Test theme syntax
rofi -show drun -theme ~/.config/rofi/space-station.rasi

# Check font dependencies
fc-list | grep -i jetbrains

📚 Getting Help

  • Component-specific issues: Check individual README files
  • Configuration problems: Each component has troubleshooting sections
  • Font issues: Ensure JetBrains Mono Nerd Font is properly installed
  • Performance issues: Check system requirements and reduce transparency

🤝 Contributing

Feel free to contribute to the cosmic journey:

🌟 Ways to Contribute

  • 🐛 Bug Reports: Found an issue? Open an issue with details
  • ✨ Feature Requests: Ideas for new cosmic features
  • 🎨 Theme Variations: Share your color scheme modifications
  • 📚 Documentation: Improve guides and add examples
  • 🚀 New Components: Add support for additional applications

📋 Contribution Guidelines

  1. Fork the repository and create a feature branch
  2. Test your changes thoroughly across different setups
  3. Update documentation for any new features
  4. Follow the cosmic theme aesthetic and naming conventions
  5. Submit a pull request with detailed description

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

Feel free to use, modify, and distribute these configurations for your own cosmic journey!


🌟 Inspiration & Credits

This cosmic configuration draws inspiration from:

  • 🌌 Deep Space & Nebula Imagery: Hubble Space Telescope photos
  • ⚡ Cyberpunk Aesthetics: Neon colors and futuristic interfaces
  • 🚀 Sci-Fi User Interfaces: Space station control panels
  • 💻 Development Workflows: Optimized for programming productivity
  • 🎭 Modern Linux Theming: Contemporary design principles

🎯 Special Thanks

  • Hyprland community for the amazing Wayland compositor
  • Waybar developers for the flexible status bar
  • Starship team for the cross-shell prompt
  • JetBrains for the excellent Mono font
  • Nerd Fonts project for programming font icons

🚀 Welcome to the Space Station 🚀

⚡ May your code compile faster than the speed of light! ⚡

Enjoy your cosmic development journey across the digital universe

About

A complete cyberpunk-cosmic themed development environment for moxer-mmh

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published