# Pulse Tweaks 1.2 Linux Preview

Requires Linux, Python 3.8+ and a desktop browser. No pip packages, root access or online account required. This is a single executable Python application, not a Windows EXE.

Install from the directory containing the download:

    python3 Pulse-Tweaks-Linux.run --install

Then open Pulse Tweaks from your application menu. To run without installing:

    python3 Pulse-Tweaks-Linux.run

The app opens a browser page served only on 127.0.0.1. Use Quit app to stop the local process; closing the browser tab alone does not stop it. The launch terminal prints a private session URL if the browser does not open. Do not share that URL.

Both platform tabs show which platform is selected. Windows controls cannot execute on Linux. The Windows download provides Windows controls; selecting its Linux tab does not emulate Linux.

Linux features: detect powerprofilesctl profiles, set an available profile and restore the original; disable/restore XDG autostart desktop entries for your user. Hardware/service availability varies. It does not include the Windows benchmark importer or connection probe. No measured FPS or latency gains are claimed.

Power changes require the desktop power service to grant your user permission. Pulse never invokes sudo. Performance can increase heat and power consumption. Close games before changes.

Startup changes take effect next login, do not stop running apps, and do not alter system services. Desktop-specific startup managers may differ. Entries with unsupported names, malformed content, or symbolic links are excluded. Restore stops if a file was changed by another program. Original user files (including absence) are saved before mutation, preserving bytes and basic permission bits. ACLs and extended attributes are not preserved.

Backups: $XDG_STATE_HOME/pulse-tweaks, default ~/.local/state/pulse-tweaks. Keep this directory to retain recovery. If a power rollback fails, the original profile remains in power.json. Restore controls report errors instead of declaring success.

Uninstall: restore changes in the app first, Quit, then remove ~/.local/share/pulse-tweaks/Pulse-Tweaks-Linux.run and ~/.local/share/applications/pulse-tweaks.desktop. Backups are intentionally preserved.

Validation: 11 automated Linux tests cover real temporary-file changes and restoration, external-edit protection, invalid backup/paths, HTTP authentication/origin/host checks, foreign-platform rejection, and a mocked power service. Headless Ubuntu execution and packaged HTTP startup checked. Desktop menus, browser rendering and physical power hardware are not validated. Windows has 50 mocked/pure checks; Windows runtime testing remains outstanding. This remains a preview, not an enterprise release.

Build: python3 build.py (Python standard library). Tests: python3 -m unittest discover -s . -v