Skip to content

BradHeff/ArxisOS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

11 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

ArxisOS Logo

ArxisOS

A Modern, Elegant Linux Distribution Built for Performance and Beauty

Features β€’ Screenshots β€’ Installation β€’ Package Management β€’ Building β€’ Contributing

Version Base Desktop License


Overview

ArxisOS is a beautifully crafted Linux distribution based on Fedora 43, featuring the KDE Plasma 6 desktop environment. Designed with a focus on aesthetics, performance, and user experience, ArxisOS combines the stability and security of Fedora with a stunning custom visual identity.

Whether you're a developer, creative professional, or everyday user, ArxisOS provides a polished, cohesive experience right out of the box.


Features

Desktop Experience

Feature Description
KDE Plasma 6 The latest Plasma desktop with Wayland and X11 support
PurPurDay Theme Custom global theme with matching colors, icons, and decorations
Magna-Glassy Icons Beautiful glassy icon theme for a modern look
Oreo Cursors Elegant white cursor theme
Custom Plymouth ArxisOS branded boot splash
SDDM Theme Matching login screen with ArxisOS branding
GRUB Theme Custom bootloader theme

System Features

  • Fedora 43 Base β€” Latest packages, cutting-edge kernel, and excellent hardware support
  • SELinux Enabled β€” Enterprise-grade security out of the box
  • Flatpak Ready β€” Access to thousands of applications via Flathub
  • DNF Package Manager β€” Fast, reliable package management
  • Systemd β€” Modern init system with excellent service management
  • Btrfs Support β€” Advanced filesystem with snapshots and compression

Pre-installed Applications

Category Applications
Web Firefox
Office LibreOffice Suite
Files Dolphin File Manager
Terminal Konsole with custom ArxisOS profile
Text Editor Kate
Images Gwenview
Documents Okular
Archive Ark
Screenshots Spectacle
Remote Desktop Remmina (RDP, VNC, SPICE)
System Plasma Discover, System Monitor

Screenshots

Boot Experience

ArxisOS GRUB Bootloader

GRUB Bootloader β€” Custom ArxisOS themed boot menu with sleek dark design

Desktop & Welcome Experience

ArxisOS Desktop

ArxisOS Desktop β€” KDE Plasma 6 with PurPurDay theme, Welcome dialogs, and stunning cityscape wallpaper

Installation Process

ArxisOS Installer - Language Selection

Anaconda Installer β€” Language and keyboard layout selection with ArxisOS branding

ArxisOS Installer - Installation Progress

Installation Progress β€” Clean, modern interface showing software installation status


System Requirements

Minimum Requirements

Component Requirement
Processor 64-bit (x86_64) CPU, 2 GHz or faster
Memory 4 GB RAM
Storage 20 GB available disk space
Graphics GPU with OpenGL 3.3 support
Display 1024x768 resolution

Recommended Requirements

Component Requirement
Processor 64-bit quad-core CPU, 3 GHz or faster
Memory 8 GB RAM or more
Storage 50 GB SSD
Graphics GPU with Vulkan support
Display 1920x1080 or higher

Installation

Download

Download the latest ArxisOS ISO from the Releases page.

Creating Bootable Media

Linux

sudo dd if=ArxisOS-1.0-x86_64.iso of=/dev/sdX bs=4M status=progress oflag=sync

Windows

Use Rufus or balenaEtcher

macOS

sudo dd if=ArxisOS-1.0-x86_64.iso of=/dev/diskN bs=4m

Installation Process

  1. Boot from the USB/DVD
  2. Select "Start ArxisOS" from the boot menu
  3. Once the live desktop loads, click "Install ArxisOS" on the desktop
  4. Follow the Anaconda installer wizard
  5. Reboot and enjoy ArxisOS!

Live Session

The live environment includes a fully functional KDE Plasma desktop with automatic login. You can explore ArxisOS before installing.

  • Default User: liveuser (no password, passwordless sudo)
  • Session: Plasma X11

Package Management

Current: DNF (Fedora Package Manager)

ArxisOS currently uses DNF with access to Fedora 43 repositories:

# Update system
sudo dnf upgrade

# Install a package
sudo dnf install package-name

# Search for packages
dnf search keyword

# Remove a package
sudo dnf remove package-name

Flatpak

Flatpak is pre-installed for sandboxed applications:

# Add Flathub repository
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# Install an application
flatpak install flathub org.application.Name

# Run a Flatpak application
flatpak run org.application.Name

ApM β€” Arxis Package Manager

Status

Coming Soon

We are developing ApM (Arxis Package Manager) β€” a next-generation package manager designed specifically for ArxisOS. Inspired by the simplicity and power of Arch Linux's pacman and AUR, ApM will provide:

Feature Description
Native .apm Packages Lightweight, efficient package format designed for ArxisOS
RPM Compatibility Seamless installation of Fedora/RHEL .rpm packages
ApR Repository Community-driven package repository (like Arch's AUR)
APMBUILD System Simple, readable build scripts for package creation
Built in Rust Blazing-fast performance with parallel downloads

ApM Documentation

Want to learn more? Check out the ApM Documentation for detailed information on package format, CLI usage, building packages, the ApR repository system, and RPM compatibility.


Building ArxisOS

Prerequisites

  • Fedora 43 or compatible system
  • osbuild-composer for image building
  • Root/sudo access
  • ~50GB free disk space

Build Process

  1. Clone the repository:

    git clone https://github.com/arxisos/arxisos-build.git
    cd arxisos-build
  2. Start osbuild-composer:

    sudo systemctl start osbuild-composer.socket
  3. Build the base ISO:

    ./scripts/build-iso.sh --wait
  4. Apply ArxisOS branding:

    sudo ./scripts/apply-composer-branding.sh <base-iso> ArxisOS-1.0-x86_64.iso

Project Structure

arxisos-build/
β”œβ”€β”€ blueprints/           # osbuild-composer blueprints
β”‚   └── arxisos-kde.toml  # Main KDE Plasma blueprint
β”œβ”€β”€ branding/             # Visual assets
β”‚   β”œβ”€β”€ logos/            # ArxisOS logos and icons
β”‚   β”œβ”€β”€ wallpapers/       # Desktop wallpapers
β”‚   β”œβ”€β”€ plymouth/         # Boot splash theme
β”‚   β”œβ”€β”€ grub/             # Bootloader theme
β”‚   β”œβ”€β”€ sddm/             # Login manager theme
β”‚   β”œβ”€β”€ plasma-themes/    # KDE Plasma themes
β”‚   β”œβ”€β”€ icons/            # Icon themes
β”‚   └── cursors/          # Cursor themes
β”œβ”€β”€ scripts/              # Build and branding scripts
β”‚   β”œβ”€β”€ build-iso.sh      # ISO build script
β”‚   └── apply-composer-branding.sh  # Branding application
β”œβ”€β”€ Screenshots/          # OS screenshots for documentation
β”œβ”€β”€ PLASMA-CONFIGS/       # KDE configuration files
β”œβ”€β”€ Skel/                 # User skeleton files
β”œβ”€β”€ APM.md                # ApM Package Manager documentation
└── README.md             # This file

Customization

Changing Themes

ArxisOS uses KDE Plasma's standard theming system:

  1. Open System Settings
  2. Navigate to Appearance
  3. Customize:
    • Global Theme β€” Overall look and feel
    • Plasma Style β€” Panel and widget appearance
    • Colors β€” System color scheme
    • Window Decorations β€” Titlebar style
    • Icons β€” Icon theme
    • Cursors β€” Mouse cursor theme

Wallpapers

Default wallpapers are located in /usr/share/wallpapers/ArxisOS/.

To add custom wallpapers, place them in ~/.local/share/wallpapers/.


Troubleshooting

Boot Issues

Black screen after boot:

  • Try booting with the "Basic Graphics" option
  • Add nomodeset to kernel parameters

Plymouth not showing:

  • Ensure rhgb quiet are in kernel parameters
  • Rebuild initramfs: sudo dracut -f

Display Issues

Wrong resolution:

  • Open System Settings β†’ Display and Monitor
  • Configure your display settings

Wayland issues:

  • Log out and select "Plasma (X11)" from the session menu

Package Issues

DNF slow:

sudo dnf makecache

Broken dependencies:

sudo dnf distro-sync

Contributing

We welcome contributions to ArxisOS! Here's how you can help:

Reporting Issues

  • Use the GitHub Issues page
  • Include system information: fastfetch or inxi -F
  • Provide steps to reproduce the issue

Development

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Commit your changes: git commit -m 'Add amazing feature'
  4. Push to the branch: git push origin feature/amazing-feature
  5. Open a Pull Request

Areas of Contribution

  • Theming β€” Improve or create new visual themes
  • Documentation β€” Help improve docs and guides
  • Testing β€” Test on different hardware configurations
  • Translations β€” Help translate ArxisOS
  • ApM Development β€” Contribute to the package manager

Roadmap

Version 1.0 (Current)

  • KDE Plasma 6 desktop
  • PurPurDay theme integration
  • Custom boot splash and login screen
  • GRUB theming
  • Pre-installed applications

Version 1.1 (Planned)

  • ApM package manager (alpha)
  • ArxisOS Welcome application
  • Additional wallpapers
  • Improved installer experience

Version 2.0 (Future)

  • ApM package manager (stable)
  • ApR community repository
  • ArxisOS-specific applications
  • ARM64 support

Credits

Developer

Brad Heffernan β€” Creator and Lead Developer

Acknowledgments


License

ArxisOS is distributed under the GNU General Public License v3.0.

See LICENSE for more information.


Links


ArxisOS β€” Where Beauty Meets Performance

Made with ❀️ in Australia

About

Fedora 43 based Plasma spin rebranded for learning purposes.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors