Restructure codebase into modular architecture

[ledati16]

This pull request rebrands the project from "NASW" (Niri Audio Switcher) to "PWSW" (PipeWire Switcher), broadening its scope from a Niri-specific tool to a Wayland compositor-agnostic audio switcher. The documentation, configuration, and build files have all been updated to reflect this new focus, including support for multiple compositors via standard Wayland protocols and improved clarity on usage, supported platforms, and architecture. Additionally, a new CLAUDE.md file has been added to provide detailed guidance for contributors and LLMs.

Project rebranding and scope expansion:

• Renamed the project from "NASW" to "PWSW" throughout all documentation and build files, including updates to the binary name, configuration paths, and repository links. The description now reflects support for multiple Wayland compositors rather than just Niri. [1] [2] [3] [4] [5] [6] [7] [8]

Documentation and configuration improvements:

• Updated the README to document new supported compositors (Sway, Hyprland, Niri, KDE Plasma, etc.) via standard Wayland protocols (wlr-foreign-toplevel-management and plasma-window-management), and clarified that GNOME/Mutter is not supported.
• Modernized and clarified CLI command usage, configuration file locations, and example config, replacing Niri-specific instructions with compositor-agnostic guidance. [1] [2] [3] [4] [5]

Build system and dependency updates:

• Updated Cargo.toml to reflect the new project name, version, description, keywords, and repository. Added explicit dependencies for Wayland protocol support (wayland-client, wayland-protocols-wlr, wayland-protocols-plasma) and expanded Tokio features.

Contributor guidance:

• Added a comprehensive CLAUDE.md file with project overview, architecture, build instructions, configuration notes, and common pitfalls to assist contributors and LLMs in understanding and safely modifying the codebase.

General improvements and clarifications:

• Improved explanations of the threading model, IPC infrastructure, and configuration validation. Updated references to commands, file paths, and environment variables to match the new project name and broadened scope. [1] [2] [3] [4]This pull request introduces a major rebranding and architectural clarification for the project, transitioning from "NASW" (Niri Audio Switcher) to "PWSW" (PipeWire Switcher). The changes include renaming, documentation updates, and improved clarity about supported compositors, protocols, and usage. Additionally, a comprehensive developer guide (CLAUDE.md) is added, and the Cargo.toml is updated to reflect new dependencies and project metadata.

Project rebranding and documentation overhaul:

• The project is renamed from "NASW" to "PWSW" throughout the codebase and documentation, including all references in README.md, Cargo.toml, and configuration examples. The description and keywords are updated to reflect broader Wayland compositor support, not just Niri. [1] [2] [3] [4] [5] [6] [7] [8]

Expanded compositor and protocol support:

• The documentation now clarifies that PWSW supports a wide range of Wayland compositors via standard protocols (wlr-foreign-toplevel-management and plasma-window-management), listing compatible compositors explicitly and noting that GNOME/Mutter is not supported.

Improved user and developer guidance:

• A new CLAUDE.md file provides a detailed overview of the architecture, threading model, configuration, and testing procedures for developers and advanced users.
• The README.md is updated with clearer instructions for building, running, and managing the daemon, as well as for using IPC commands and finding relevant configuration fields. [1] [2]

Dependency and configuration updates:

• Cargo.toml is updated with new project metadata, repository URL, and additional dependencies for Wayland protocol support (wayland-client, wayland-protocols-wlr, wayland-protocols-plasma). The tokio dependency is expanded with more features for async support.

Configuration and usage improvements:

• The configuration examples and documentation are updated to reflect new command names, improved notification settings, and better guidance for discovering window/app IDs across various compositors. [1] [2]

These changes collectively modernize the project, clarify its scope and usage, and provide both users and contributors with more comprehensive and accurate information.This pull request renames the project from "NASW" (Niri Audio Switcher) to "PWSW" (PipeWire Switcher) and broadens its focus from the Niri compositor to general Wayland compositors using standard window management protocols. The documentation and configuration have been updated to reflect this, and the codebase now includes new modules for CLI argument parsing and command handling. The most important changes are summarized below.

Project-wide rebranding and protocol support:

• The project is renamed from "nasw" to "pwsw" throughout the codebase, documentation, and configuration. The repository URL, binary name, config directory, and all references are updated accordingly. [1] [2] [3] [4] [5] [6] [7] [8]
• The tool now supports all Wayland compositors that implement the wlr-foreign-toplevel-management or plasma-window-management protocols, rather than being specific to Niri. The documentation lists supported compositors and explains the use of standard protocols for broader compatibility. [1] [2]

Documentation and configuration updates:

• The README.md is extensively revised to reflect the new name, supported compositors, updated usage examples, and configuration paths. Instructions and examples now use pwsw instead of nasw, and references to Niri-specific features are replaced with Wayland protocol-based descriptions. [1] [2] [3] [4] [5] [6]

Dependency and build updates:

• Cargo.toml is updated to add dependencies for Wayland protocol support (wayland-client, wayland-protocols-wlr, wayland-protocols-plasma) and to enable the sync feature for tokio. The project metadata is updated to match the new name and scope.

New and refactored code modules:

• A new src/cli.rs module defines the command-line interface using clap, including detailed help and argument parsing for all supported commands.
• A new src/commands.rs module implements the logic for one-shot CLI commands such as --list-sinks, --get-sink, --set-sink, --next-sink, and --prev-sink, with improved output formatting and integration with the updated configuration.Split monolithic main.rs into focused modules to support:

• Multi-compositor backends (Niri, Sway, Hyprland)
• Future TUI integration
• Cleaner separation of concerns

New structure:

• src/lib.rs: Library crate with module re-exports
• src/bin/nasw.rs: Binary entry point
• src/cli.rs: CLI argument definitions
• src/config.rs: Configuration loading and validation
• src/pipewire.rs: PipeWire types and interface
• src/notification.rs: Desktop notifications and icons
• src/state.rs: Application state and event processing
• src/commands.rs: One-shot CLI commands
• src/daemon.rs: Daemon mode event loop
• src/compositor/: Compositor abstraction layer
  • mod.rs: Compositor trait and WindowEvent enum
  • niri.rs: Niri IPC implementation

This enables adding Sway/Hyprland support by implementing the
Compositor trait, and prepares for a separate TUI binary that
can share the library code.