Naarchy

Product Introduction

1. Definition: Naarchy is a native Linux desktop widget application, specifically a GTK4-based panel or "island," built with the Rust programming language. It functions as a centralized productivity hub that sits at the top of the screen, integrating multiple utilities into a single, cohesive interface.
2. Core Value Proposition: Naarchy exists to reduce context switching and streamline the Linux desktop workflow by consolidating essential tools—file access, clipboard history, media controls, a focus timer, and calendar events—into a persistent, always-accessible overlay. Its core value is providing a minimalist, privacy-focused desktop enhancement that keeps a user's workflow tools within immediate reach without requiring window management or leaving the current application.

Main Features

1. Integrated File Shelf: Provides quick, searchable access to a user-defined directory (a "shelf") directly from the desktop overlay. It leverages the native Linux filesystem and GTK4's file chooser and search capabilities, allowing for rapid file retrieval without opening a separate file manager window.
2. Searchable Clipboard History: Maintains a local, searchable history of copied text and images. This feature operates entirely on the user's machine, storing clipboard data in a local database (likely SQLite, given Rust's common tooling) with no cloud synchronization, aligning with its privacy-first ethos. Users can search through past clipboard entries via a text input field within the widget.
3. MPRIS Media Controls & Focus Timer: Integrates directly with the MPRIS2 (Media Player Remote Interfacing Specification) D-Bus interface, a standard for controlling media players on Linux. This allows Naarchy to display album art, track information, and provide play/pause/next/previous controls for compatible players like Spotify, VLC, or cmus. The built-in Pomodoro-style focus timer is a standalone Rust-based countdown utility that can be started, paused, and managed from the widget.
4. Calendar Integration & Desktop Integration: Can pull and display events from locally configured calendar sources (e.g., via .ics feeds). The widget is built with gtk4-layer-shell for Wayland compositors, allowing it to create an overlay layer that sits above normal windows but below critical system UI. It is designed to follow the system color theme (particularly for Omarchy) and can be positioned and sized by the user.

Problems Solved

1. Pain Point: Fragmented workflow on Linux desktops, where users must constantly alt-tab between applications (file manager, music player, calendar, timer app) or rely on separate, often bulky, system tray widgets or extensions, leading to distraction and reduced productivity.
2. Target Audience: The primary audience is Linux power users and developers, specifically those using tiling window managers or minimalist desktop environments like Hyprland or Omarchy who value keyboard-driven workflows, screen real estate, and system integration. A secondary audience includes privacy-conscious users and Rust enthusiasts interested in native GTK4 applications.
3. Use Cases:
   • Coding/Development: Quickly referencing a recently copied error message from clipboard history or opening a project file from the shelf without leaving the IDE.
   • Writing/Research: Managing focus sessions with the built-in timer while controlling background music and having frequent documents or snippets accessible.
   • General Productivity: Keeping an eye on the day's upcoming calendar events while working in full-screen applications, all from a unified, non-intrusive panel.

Unique Advantages

1. Strengths & Limitations (Pros & Cons):
   • Pros:
     • Privacy-Centric Design: No telemetry, no account, no cloud sync for sensitive data like clipboard and files. Data stays local.
     • Native Performance: Built in Rust and GTK4, resulting in a fast, lightweight, and memory-efficient application that feels integrated with the desktop.
     • Unified Workflow: Successfully consolidates multiple common tools into a single, consistent interface, reducing clutter and cognitive load.
     • Aesthetic Customization: Designed to blend with modern Linux desktop aesthetics, especially Omarchy, with configurable appearance.
   • Cons:
     • Limited Platform Support: Exclusively for Linux, with primary support for Wayland compositors (Hyprland) and Omarchy. Not for Windows, macOS, or X11-based desktops without potential modification.
     • Niche Audience: The focus on tiling window managers and a specific workflow may have a steeper learning curve for users of traditional desktop environments like GNOME or KDE Plasma.
     • Early Stage (v0.4): As a sub-1.0 release, it may lack some polish, advanced configuration options, or extensive documentation compared to established alternatives.
2. Key Alternatives & Differentiation:
   • Traditional Desktop Widgets (Conky, GNOME Extensions): Conky is highly configurable but requires significant scripting and does not integrate features into a single interactive UI. GNOME Extensions are often JavaScript-based and can be less performant; they also scatter functionality across multiple, separate extensions. Naarchy differentiates by being a unified, interactive, native application focused on a cohesive user experience.
   • Dedicated Clipboard Managers (CopyQ, GPaste): Tools like CopyQ are powerful and feature-rich for clipboard history. Naarchy integrates this as one feature among many, sacrificing some advanced clipboard management power for the benefit of a unified workflow hub.
   • Commercial macOS Utilities (Alfred, Raycast): Alfred and Raycast are powerful, polished launchers with plugin ecosystems. Naarchy is the open-source, Linux-native, privacy-focused counterpart in this space, but currently with a more focused and limited set of core features compared to their extensive plugin libraries.

Frequently Asked Questions (FAQ)

1. Is Naarchy compatible with GNOME or KDE Plasma? Naarchy is primarily built and tested for Wayland compositors like Hyprland and the Omarchy environment. While it may run on other GTK4-based desktops like GNOME on Wayland, full functionality and seamless integration are not guaranteed. It is not designed for X11-based environments.
2. How does Naarchy handle privacy and user data? Naarchy is designed with a strong privacy focus: clipboard history and file shelf data are stored locally on your machine and are not encrypted by default. Calendar integration may fetch data from remote .ics feeds, and media controls may fetch album art. The application does not include telemetry, analytics, or require any user account.
3. Can I contribute to Naarchy or modify it for my needs? Yes. Naarchy is released under the permissive MIT license, and its source code is fully available on GitHub. Users are free to fork, modify, and distribute their own versions, and contributions to the main project are welcomed, aligning with its open-source philosophy.
4. What are the system requirements to install and run Naarchy? To run Naarchy, you need a Linux system with a Wayland compositor (preferably Hyprland), Rust toolchain (v1.92+), GTK4 and gtk4-layer-shell libraries, and basic development tools. On Arch Linux/Omarchy, these can be installed via pacman. Detailed build and installation instructions are provided in the project's documentation.
5. How does Naarchy compare to using a traditional application launcher? Naarchy is less of a full application launcher and more of a persistent productivity dashboard. While some launchers can be extended with plugins for similar functions, Naarchy provides these features—file shelf, clipboard, timer, media, calendar—in a constantly visible, instantly accessible overlay designed to minimize interaction time and keep you in your flow state.