From fa564b8cef6aa05fa81cf61db439dec640f585a4 Mon Sep 17 00:00:00 2001 From: SocioCybereeng Date: Thu, 25 Jun 2026 11:56:58 +0000 Subject: [PATCH] Readme and license --- Readme.md | 260 ++++++++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 232 insertions(+), 28 deletions(-) diff --git a/Readme.md b/Readme.md index 1503c8b..d7721f7 100644 --- a/Readme.md +++ b/Readme.md @@ -1,38 +1,242 @@ # LinaraOS -Linara OS -Science for Everyone +**LinaraOS** is a GNU/Linux distribution built on [Artix Linux](https://artixlinux.org) — an Arch-based, systemd-free operating system. It is designed as a complete workstation for science, privacy, electronic engineering, creative work, AI-assisted learning, and beyond. -- Learn Science easy -- Research, Read Books, AI -- Design an electronic devices [PCBs] (KiCAD) -- Make Animations, posters, arts -- Programming with AI (opencode) -- Hidden Networks +> *"Science for Everyone"* -Linara OS is a GNU/Linux distribution. -Based on Artix Linux. -Default init system is Openrc. +--- -This operating system include: -- Control Center with AI chats, Media Links,. -- Design Programs -- Network Programs -- Media Programs -- Notes Programs -- Games -- Custom scripts. -- System proxy for bypass censorship. (Nekoray + Hysteria2) -- And so on. +## Overview -With Linara OS you can learn science easy. - -In web browser you can find useful bookmarks with AI-tools., for research science papers. +| Property | Value | +|---|---| +| Base | Artix Linux (Arch-based) | +| Default Init | OpenRC | +| Supported Inits | OpenRC, Dinit, Runit, S6 | +| Desktop | XFCE4 + Hyprland | +| Login Manager | Ly | +| Boot Splash | Plymouth (LinaraOS theme) | +| Bootloader | GRUB (LinaraOS theme) | +| Live User | `linara` / `linara` | +| Architecture | x86_64 | -Desktop Enviroment -Hyperland + Xfce4 +--- -DE: Xfce4 can be useful then Hyperland. -For KiCAD when you Design a PCB. +## Purpose +LinaraOS is built for people who do serious work: +- **Science & Research** — access AI tools, science paper databases, and a full office suite out of the box +- **Anonymity & Privacy** — Tor, I2P, privacy-hardened browser, and traffic bypass tools pre-installed +- **Electronic Design** — full KiCAD suite with 3D libraries and demos for PCB design +- **3D & Visual Arts** — vector graphics, digital painting, and image processing tools +- **Learning & Programming** — Rust toolchain, development tools, QEMU virtualization, and AI-assisted coding +- **AI** — curated browser bookmarks linking to AI tools and research resources +- **Media Production** — screen recording, audio editing, video playback, and music tools +- **Security & Networks** — Wireshark, Nmap, Flashrom, and network analysis utilities + +--- + +## Desktop Environments + +### XFCE4 (Primary) +The default desktop. Lightweight, stable, and practical for daily use — especially for KiCAD PCB design and general workflows. Launches automatically on login. + +### Hyprland (Wayland) +A dynamic tiling Wayland compositor for power users. Includes Hyprpaper (wallpaper), Waybar (status bar), and full XDG portal integration (`xdg-desktop-portal-hyprland`, `-wlr`, `-gtk`, `-xapp`). + +--- + +## Software + +### Privacy & Anonymity +| Software | Description | +|---|---| +| Librewolf | Privacy-hardened Firefox fork | +| Tor Browser | Anonymous browsing via the Tor network | +| I2P (i2pd) | Invisible Internet Project — anonymous overlay network | +| Wireshark | Network protocol analyzer | +| Nmap | Network discovery and security scanning | +| KeePassXC | Offline password manager | +| Nekoray + Hysteria2 | System proxy for censorship bypass | + +### Electronic Design +| Software | Description | +|---|---| +| KiCAD | Professional PCB and schematic design suite | +| KiCAD Library | Standard symbol and footprint libraries | +| KiCAD 3D Library | 3D component models for PCB visualization | +| KiCAD Demos | Example projects | +| Arduino IDE | Microcontroller programming environment | +| Flashrom | Firmware chip reading/writing tool | +| Android Tools (ADB/Fastboot) | Android device interfacing | + +### Science & Research +| Software | Description | +|---|---| +| LibreOffice Fresh | Full office suite (Writer, Calc, Impress, Draw) | +| Atril | Scientific and general document viewer | +| AI Bookmarks | Curated browser bookmarks for AI tools and science paper databases | + +### Creative & Visual Arts +| Software | Description | +|---|---| +| Inkscape | Professional vector graphics editor | +| Krita | Digital painting and illustration | +| ImageMagick | Command-line image processing | +| Flameshot | Screenshot and annotation tool | +| Feh | Lightweight image viewer | + +### Media Production +| Software | Description | +|---|---| +| OBS Studio | Screen recording and live streaming | +| Audacity | Audio recording and editing | +| MPV | Versatile media player | +| FFmpeg | Audio/video conversion and processing | +| CMUS | Terminal-based music player | + +### Development & Programming +| Software | Description | +|---|---| +| Rustup | Rust programming language toolchain manager | +| Git | Version control | +| base-devel | GCC, Make, and core build tools | +| CMake | Cross-platform build system | +| QEMU (full) | Full system and user-mode emulation / virtualization | +| Fish Shell | User-friendly interactive shell | +| Ranger + FZF | Terminal file manager with fuzzy finder | + +### Security & Networking +| Software | Description | +|---|---| +| ConnMan + connman-gtk | Network connection manager | +| QBittorrent | BitTorrent client | +| FileZilla | FTP/SFTP client | +| Wireshark | Packet capture and analysis | +| Nmap | Port scanner and network mapper | + +### System & Utilities +| Software | Description | +|---|---| +| PipeWire + WirePlumber | Modern audio/video server | +| Pavucontrol | PulseAudio/PipeWire volume control | +| BTOP | Resource monitor | +| BleachBit | System cleaner | +| Thunar + Archive Plugin | File manager with archive integration | +| File Roller | Archive manager | +| Leafpad | Lightweight text editor | +| GNOME Keyring | Credential storage | + +### Gaming +| Software | Description | +|---|---| +| Xonotic | Fast-paced open-source first-person shooter | + +--- + +## System Architecture + +### Init System +LinaraOS ships with **OpenRC** by default. The ISO build also supports **Dinit**, **Runit**, and **S6** — selectable at install time via the Calamares installer. + +### Graphics Stack +- Mesa (open-source GPU drivers) +- Vulkan (via `vulkan-intel`) +- Intel Media Driver (VA-API hardware acceleration) +- Xorg drivers: Intel, AMD, ATI, Nouveau, AMDGPU, VESA, and more + +### Audio +PipeWire handles all audio with `pipewire-pulse` for PulseAudio compatibility, `pipewire-alsa` for ALSA compatibility, and WirePlumber as the session manager. + +### Boot +- **GRUB** with a custom LinaraOS theme (white rounded menu, dark background) +- **Plymouth** splash screen with the LinaraOS theme during boot +- Kernel parameters: `quiet splash loglevel=3 vt.global_cursor_default=0` + +--- + +## Live Session + +Boot from the ISO to try LinaraOS without installing anything. + +| | | +|---|---| +| Username | `linara` | +| Password | `linara` | +| Autologin | Yes (XFCE4 via Ly) | +| Hostname | `artix-live` | + +The live session has full access to all pre-installed software. + +--- + +## Installation + +LinaraOS includes the **Calamares** graphical installer with two modes: + +- **Offline** — installs the full pre-built system from the ISO image. Fast and reliable. +- **Online** — lets you select packages and init system during setup. Requires an internet connection. + +### Offline Install Steps +1. Boot the ISO +2. Launch the installer from the desktop +3. Select language, keyboard, timezone, and disk partitioning +4. Create your user account +5. Confirm and install + +--- + +## Repository Structure + +``` +iso-profiles/ +├── xfce/ # XFCE profile (primary) +│ ├── profile.yaml # Package lists and service config +│ ├── root-overlay/ # Files placed on the installed system +│ └── set_grub_theme.sh # GRUB theme activation script +├── common/ # Shared base across all profiles +│ ├── root-overlay/ # Base system config (grub, fstab, etc.) +│ ├── live-overlay/ # Live ISO-specific config (autologin, etc.) +│ ├── gtk/root-overlay/ # GTK theming and GRUB theme assets +│ └── conf/ # Calamares installer configuration +├── base/ +├── cinnamon/ +├── plasma/ +└── ... +``` + +--- + +## Building the ISO + +Requires [artools](https://gitea.artixlinux.org/artix/artools) on an Artix Linux host. + +```bash +# Build with OpenRC (default) +buildiso -p xfce -i openrc + +# Build with Dinit +buildiso -p xfce -i dinit + +# Build with Runit +buildiso -p xfce -i runit + +# Build with S6 +buildiso -p xfce -i s6 +``` + +After installation, apply the GRUB theme: +```bash +sudo bash set_grub_theme.sh +``` + +--- + +## License + +See [LICENSE](LICENSE). + +--- + +*LinaraOS — SOCIO-CYBEREENG — THE OPERATING SYSTEM*