Getting Started

Click to get to each homepage:

Important: Avoid using scripts from other branches or projects as they may disrupt Xkaliber functionality.

Make sure to do a sudo apt update && sudo apt upgrade

Then sudo apt full-upgrade or do all upgrades from Pop Shop as an option.

Desktops can be changed at any time from the login screen!

Desktop Change

Downloads

Get Started with Xkaliber System

Password for all ISOs: 0000

Choose the version that best suits your needs:

Xkaliber Trixie (Unveiled Edition - Stable Release)

The image is still in testing, but it is stable.

Xkaliber Trixie offers broad device compatibility and performance enhancements based on Debian Trixie. A huge thanks again to Mark Dodd for his work on device compatibilities and the Cinnamon desktop integration!

This edition provides a clean and streamlined installation experience. It boots into a vanilla Trixie system, and then offers an innovative feature installer invoked through simple commands. This allows you to selectively install our custom features and software packages at your convenience, keeping your base system clean and tailored to your needs.

Key improvements in this Unveiled Edition:

  • Enhanced Stability: Thoroughly tested and patched to ensure a rock-solid and dependable system.
  • Clean Installation with Feature Commands: Starts with a pristine Trixie base, allowing you to add features as you need them via simple commands.
  • Updated Custom Packages: Includes the latest version of our custom packages, such as xmedia, which now features expanded options for file conversion and media processing.
  • Full Feature Set (Minus Desktop Alternatives): While some desktop environment alternatives are temporarily unavailable, all core functionalities and features are included and ready to use.
  • Universal Device Support: Confirmed compatibility across a wide range of hardware, including the latest devices like Legion Go and Asus Ally.

Ideal for: Users needing a stable and up-to-date system with support for the latest devices, including Legion Go and Asus Ally, who appreciate a clean base install with optional feature additions. Runs on Debian Trixie.

Supported Devices: All devices, including Desktop, Laptop, Steam Deck, GPD 4, Legion Go, Asus Ally

Experience the latest Xkaliber system based on Debian Trixie, offering broader device compatibility and performance enhancements in a stable and refined package. This edition receives architectural updates past bookworm.

  • Key Features:
    • Cinnamon Desktop Environment: Select it from the login menu. Visually very close to Windows, Cinnamon feels like a full-blown DE but is lightweight and very fast.
    • Supports All Devices: Compatible with a wide range of devices, including Legion Go and Asus Ally.
    • Debian Trixie Based: Runs on the latest Debian Trixie for improved performance and device support.
    • Quality of Life Update: Includes updates for a smoother user experience.
    • Feature Commands: Install optional features and packages post-installation using simple commands in the terminal.
  • Download ISO (Trixie Unveiled Edition) - Get the latest Xkaliber Trixie operating system image.
  • Download MD5 - Verify the integrity of your downloaded ISO file. *(MD5 will be provided once generated)*

Getting Started with Feature Installation (Trixie Unveiled Edition)

After installing Xkaliber Trixie Unveiled, you can easily install additional features and software packages using specific commands. Before using any of these installation commands, it's essential to execute xdocker.sh first to initialize the necessary container environment.

To use these features, simply open your terminal and type in the command you wish to use, then press Enter. These commands are recognized system-wide.

Here's a brief overview of the available installation commands:

  • aisetup.sh: Effortlessly install and configure popular AI tools like Ollama, Open WebUI, and Stable Diffusion through an intuitive, user-friendly menu.
  • xdeb.sh: Simplify Debian package creation. Turn directories or scripts into .deb packages with ease.
  • xdns.sh: Boost network performance and ensure Waydroid compatibility by setting up a local DNS caching server with dnsmasq.
  • xdroid.sh: Unlock the world of Android apps on your system. Install Waydroid and gain access to the Google Play Store.
  • xmedia.sh: Enhance your media workflow with powerful processing tools, including file conversion and image upscaling.
  • xram.sh: Optimize memory usage and improve system responsiveness by configuring ZRAM.
  • xsnap.sh: Expand your application library by installing the Snap Store, providing access to a vast selection of software.
  • xsteam.sh: Enjoy secure and isolated gaming by deploying Steam within a dedicated environment.
  • xsunshine.sh: Reliably install sunshine for remote desktop streaming.
  • xrocm.sh: Install the ROCm HIP libraries, enabling accelerated AI application performance.

Detailed instructions and usage guides for these commands will be provided in a separate "XkaliberOS Installation and Configuration Guide" document coming soon. Please ensure you execute xdocker.sh before attempting to use any of the feature installation commands.

Xkaliber Classic — Bookworm (Updated - NVIDIA Driver Fix)

Our best, and recommended image, now with improved stability and NVIDIA driver compatibility.

Important Note Regarding NVIDIA Drivers: Recent NVIDIA driver updates introduced incompatibilities that caused issues, particularly for AI applications, on the Bookworm system. This updated ISO resolves these problems by reverting to older, stable NVIDIA drivers and blacklisting the problematic updates. This ensures a smooth and reliable experience, especially for users relying on NVIDIA GPUs for AI or general use. While the ISO size is larger, 20GB, due to these included fixes, the benefit is a significantly more stable system.

Ideal for: Users seeking a dedicated stable sandbox system limited to bookworm, especially those utilizing NVIDIA GPUs and AI applications. Xkaliber classic is intended specifically for developers or users that want a sandboxed Debian 12 experience.

Supported Devices: Desktop, Laptop, Steam Deck, GPD 4

Not Recommended for: AMD z1 extreme devices, Legion Go, Asus Ally (Use Xkaliber 6.11 for these devices).
On Z1 Extreme GPU you may experience screen flickering.

This Xkaliber Classic image is a bookworm Debian version and will remain as bookworm Debian forever. For the latest Debian Trixie based Xkaliber with support for newer devices, please use the Xkaliber Trixie version.

  • Key Features:
    • Stable Bookworm System: A dedicated stable sandbox system based on bookworm Debian.
    • Classic Experience: Offers a bookworm Debian experience, distinct from the newer Trixie based versions.
    • Tested Compatibility: Verified to be working on Desktop, Laptop, Steam Deck, and GPD 4.
    • NVIDIA Driver Stability Focus: Includes older, stable NVIDIA drivers and blacklists problematic updates to ensure compatibility and prevent issues, especially for AI applications.
    • Pre-installed Features: All features like AI tools, Debian package creation tools, DNS server, Waydroid, media tools, memory optimization, Snap Store, Steam, remote desktop streaming, and ROCm HIP libraries are pre-installed and ready to use. None of the feature commands available in the Trixie version are present in the classic edition as all features come preinstalled.
  • Download ISO 20GB (bookworm classic) - Get the updated bookworm classic operating system image.

Community/Advanced User Focused Minimal ISO (Base Bare Image)

Ideal for: Enthusiasts and advanced users who want to personalize their build of Xkaliber while only incorporating pop shop.

  • Key Features:
    • Minimal Base System: Starts with a bare image for maximum customization.
    • Includes Pop Shop: For easy installation of additional applications.
    • For Enthusiasts: Designed for users comfortable with system configuration.
  • Download Base Bare Image ISO - This iso is our base bare image.

Developer Tools & Scripts

Use these scripts can to configure your system after installation:

NVIDIA Driver and Utility Script

Purpose: Streamlines the installation of necessary NVIDIA drivers, dependencies, and the Snap Store.

Important Usage Note: This utility, xutility.sh, is intended exclusively for users of bare image installations. It is not required or recommended for our main images, which already include necessary NVIDIA components. Using it on main images may lead to conflicts or unexpected behavior.

  • Download xutility.sh
  • Important: After downloading, make the script executable:
    chmod +x xutility.sh
    Then, you can run the script in your terminal.

Installation Script for NVIDIA GPUs (Debian 12)

Purpose: This script automates the installation of NVIDIA on a Debian 12 systems. It simplifies the often complex installation process and includes built-in error handling to provide a smoother experience.

  • Universal System Support: Designed to work seamlessly on a broad range of hardware configurations.
  • Installing NVIDIA Drivers:

    To install NVIDIA drivers, open your terminal and run the following commands. Please note that during the driver installation process, your screen might temporarily appear magnified. Once the installation is complete, the display should return to its normal resolution.

    sudo apt -y install linux-headers-$(uname -r) build-essential libglvnd-dev pkg-config
    sudo apt install nvidia-driver
    sudo apt update
    sudo reboot
    Container Ready: Easily enable Docker for containerization. After installation, open your terminal and run:
    sudo systemctl enable docker
    sudo usermod -aG docker $USER

ROCm Stable Diffusion Image Generation Install and Setup Script for AMD GPUs (Debian 12)

Purpose: This script provides a streamlined way to install and set up Stable Diffusion for image generation on AMD GPUs using ROCm on Debian 12. Unlike just installing drivers, this script handles pulling all necessary assets and configuring files specifically for AMD GPUs, mirroring the ease-of-use that Nvidia users experience with AI setup scripts. It automates the often complex installation process.

  • Key Features:
    • Improved Installation Speed: We've updated our rmwebui.sh script to allow a faster installation processes of the Stable Diffusion image generating application.
    • Complete Stable Diffusion Setup: Goes beyond driver installation to fetch and configure all necessary components for running Stable Diffusion with ROCm on AMD GPUs.
    • AMD-Specific Configuration: Tailored for AMD GPUs, ensuring optimal settings and compatibility for image generation tasks.
    • Automated Installation: Handles system updates, dependency installations, and ROCm component setup.
    • Error Detection & Recovery: Intelligently attempts to identify and fix common issues during the setup process.
    • Optimized for Debian 12: Ensures compatibility and a smooth setup experience specifically for Debian 12.
  • How it Works: When you run this script, it will:
    1. Update your system's package lists.
    2. Install essential development tools and Python libraries required for ROCm and Stable Diffusion.
    3. Add your user to the necessary render and video groups.
    4. Download and install the official AMD GPU driver installer and necessary ROCm components.
    5. Configure files and settings needed for Stable Diffusion to utilize ROCm effectively.
  • Download: rmwebui.sh
  • Requirements:

    Before running the installation script, you must create a virtual environment to isolate the script's dependencies. This ensures a clean and controlled execution environment.

    1. Create a virtual environment: Open your terminal, navigate to the directory where you plan to run the script, and execute the following command to create a virtual environment named venv:
      python3 -m venv venv
    2. Activate the virtual environment: After creating the virtual environment, activate it using the appropriate command for your shell.
      source venv/bin/activate
    3. Running the script again: If you close the terminal or exit the application and want to run the script again in the future, you **must** reactivate the virtual environment in a new terminal session before running the script. Navigate to the script's directory in your terminal and run:
      source venv/bin/activate
      Then you can run the script again as described in the next section.
  • Important: Running the Installation Script
    1. Make the script executable: After downloading, open your terminal and navigate to the directory where you saved rmwebui.sh. Then, make the script executable by running the command:
      chmod +x rmwebui.sh
    2. Run the script with administrator privileges: Execute the script using bash:
      bash rmwebui.sh

Become an Xkaliber System Insider

Get Exclusive Early Access!

Want to be on the bleeding edge of Xkaliber System? Eager to get your hands on the latest features before anyone else?

Then we invite you to become an Xkaliber System Insider!

We're constantly pushing the boundaries of what Xkaliber can do, developing new features, refining performance, and squashing bugs to deliver the best possible experience. And now, we're opening up a special opportunity for passionate users like you to join us on the front lines of development.

Insider Program Benefits

  • Instant Access to Cutting-Edge Features: Forget waiting for the next big ISO release! As we develop new features, programs, system improvements, and fixes, you'll get them directly. No more waiting – you'll be experiencing the future of Xkaliber as it unfolds.
  • Exclusive Pre-Release Software & Updates: We have exciting new developments happening right now that aren't yet available to the general public. Insiders will be the first to test and utilize these enhancements. Think of it as a sneak peek behind the scenes and the chance to use tools and features before they are officially launched.
  • Direct Influence on Xkaliber's Future: Your feedback as an Insider is invaluable. By testing early and providing your insights, you'll directly contribute to shaping the direction of Xkaliber. Help us identify issues, suggest improvements, and ensure we're building the best OS possible.
  • Be Part of an Exclusive Community: Connect with the Xkaliber development team and other dedicated Insiders. Share your experiences, discuss new features, and be part of a community passionate about pushing the limits of Xkaliber.

What to Expect as an Insider

It's important to understand that being an Insider means you'll be working with software that is actively under development. Think of it as uncharted territory.

  • Things might be rough around the edges: Insider releases are not guaranteed to be stable or bug-free. You might encounter unexpected behavior, and that's part of the process!
  • Your feedback is crucial: As an Insider, your primary role is to test and provide detailed feedback on your experiences. We need your insights to identify and resolve issues quickly.
  • This is for the adventurous: If you enjoy tinkering, experimenting, and being on the forefront of technology, then the Insider program is for you. If you prefer rock-solid stability above all else, then sticking with the main releases might be a better fit.

Ready to become an Xkaliber System Insider and help us build the future?

Contact us via our Contact Page with the subject 'Xkaliber Insider Program' to express your interest, or join our Redit or Facebook group.

Your time and dedication as a tester are highly appreciated. Thank you for helping us make Xkaliber System even better!

Stay Connected

Official Android App (In Development)

Features:

  • Directly chat with the development team to report issues, suggest features, and get help.

Download Link (APK) - Download the app to connect with us.

Personalize Your Experience

Xkaliber Desktop Backgrounds & Media

Explore Media