VV OS Files

Release v1.0.0 - First stable release 🚀

This release marks the first stable version of VV OS with comprehensive installation system, multi-user support, and critical bug fixes.

🎯 Critical Bug Fixes

User Configuration Installation (MAJOR FIX)

• Fixed configs being installed to /root/ instead of user home directory
• All config and post-install scripts now use $VV_USER_HOME instead of ~/
• Added proper file ownership with chown -R $VV_USER:$VV_USER
• Fixes Noctalia Shell not starting after reboot
• Fixes Hyprland showing "auto-generated config" message

Noctalia Shell Service (MAJOR FIX)

• Fixed symlink pointing to non-existent file
• Now correctly points to /usr/lib/systemd/user/noctalia.service (installed by package)
• Changed target from graphical-session.target.wants to default.target.wants
• Matches override.conf requirements
• Service now properly enabled and starts on boot

Multi-User Support

• Automatically detects all non-system users (UID >= 1000)
• Interactive user creation if no users exist (gum prompts)
• Single user: auto-select
• Multiple users: multi-select with gum choose --no-limit
• Exports $VV_USER and $VV_USER_HOME for all scripts

Git Configuration Placeholders

• Shortened git placeholders in lang/en.sh
• "Your name (for git config)" → "Your name"
• "Email (for git config)" → "Email"
• Fixes gum display showing only first letter

✨ New Features

Electron Installation (electron.sh)

• Automatic Electron installation for Electron-based apps
• Uses system Electron instead of bundled versions
• Reduces disk usage and improves security
• Applied to: VS Code, Discord, Obsidian, Element

Package Managers (package-managers.sh)

• Added Flatpak support
• Automatic Flathub repository setup
• vv-flatpak-search TUI for browsing Flathub
• Integration with vv-package-manager (Official/AUR/Flatpak)

Locale Setup (locale-setup.sh)

• Automatic locale generation during installation
• Multi-select locale picker with gum
• Generates /etc/locale.gen and runs locale-gen
• Sets system locale in /etc/locale.conf

Power Management Services

• acpid.service enabled (ACPI events, power button, lid close)
• tlp.service enabled (battery optimization for laptops)
• Automatic detection with command -v checks

Multilib Repository

• Enabled multilib repository in /etc/pacman.conf
• Required for 32-bit libraries (Wine, Steam, gaming)
• Automatic pacman database sync after enabling

Internet Connection Instructions

• Added comprehensive internet setup instructions to vv-live-installer.sh
• Covers: Ethernet (DHCP), WiFi (iwctl), Mobile tethering (USB)
• Displayed before archinstall starts
• Helps users connect to internet in Live ISO environment

📦 Package Changes

Removed Packages

• quickshell-git (replaced by Noctalia Shell built with QuickShell)
• hyprgrass-git (touchscreen gestures, not needed for most users)
• neovim-git (using stable neovim instead)
• visual-studio-code-bin (using code OSS with system Electron)

Updated Packages

• strawberry-qt6 → strawberry (Qt6 version is default now)
• vesktop-bin → vesktop (now using system Electron via electron.sh)

🔧 Improvements

Installation Scripts

• All config scripts use $VV_USER_HOME consistently
• Proper error handling and user feedback
• Better logging and progress messages
• Conditional service enablement (check if binary exists)

Systemd Configuration

• Manual symlink creation for user services (systemctl --user doesn't work in chroot)
• Proper service dependencies and ordering
• Override files properly applied
• Services enabled in correct targets

Code Quality

• Removed duplicate code in archiso (build.sh copies from vv-installer)
• Consistent variable usage across all scripts
• Better comments and documentation
• Improved error messages

📚 Documentation

New Documentation

• ANDROID.md: VV OS for Android technical plan

Updated Documentation

• README.md: improved installation instructions, updated disk requirements (32 GB min)

🎮 Gaming & Applications

Package Organization

• Better categorization in packages/*.txt files
• Clearer separation between official and AUR packages
• Gaming packages consolidated (RetroArch, Wine, Steam, Lutris)

Application Updates

• Electron apps now use system Electron (saves ~500MB per app)
• Better integration with system libraries
• Improved startup times

🐛 Known Issues

• Keyboard shortcuts may not work in nested virtualization (Win11→WSL→QEMU→VV OS)
• Recommended testing environment: VirtualBox, VMware, or bare metal

📊 Statistics

• 74 files changed
• 1317 insertions(+), 194 deletions(-)
• 5 new modules: electron.sh, package-managers.sh, locale-setup.sh
• 1 new documentation file: ANDROID.md
• Major refactoring of installation system

🙏 Credits

Special thanks to: - ChatGPT - for helping with archiso build script fixes (rsync recursion issue) - Qwen - for assistance with various development tasks and problem-solving

Both stepped in when Claude Code tokens ran out during critical moments.

---

🤖 Generated with Claude Code

Co-Authored-By: Claude Sonnet 4.5 noreply@anthropic.com