Configure system tray and OS startup for AI Leaks Tweaker

The Settings tab contains two toggles that control how the application behaves at the OS level: whether closing the window hides it to the system tray, and whether the app launches automatically when you log in. Both settings are stored in the app_settings object in profiles.json and are shared across all profiles.

Minimize to tray

The Minimize to tray toggle changes what happens when you click the window’s close button.

Off (default): Clicking the close button quits the application and stops the proxy.
On: Clicking the close button hides the window. The app and proxy keep running in the background. A system tray icon appears with two menu items: Show (re-opens the window) and Quit (stops the proxy and exits).

The tray icon is rendered using pystray with a small black-and-white icon. Double-clicking the tray icon also re-opens the window.

The tray icon is created when you enable the toggle. If you disable the toggle while the window is hidden, the tray icon is removed and the close button reverts to quitting the app.

Enable Minimize to tray together with Start with OS so the app starts silently in the background on login and is always available from the tray.

Start with OS

The Start with OS toggle registers AI Leaks Tweaker to launch automatically when you log in. The exact mechanism depends on your operating system.

Windows
macOS
Linux

On Windows, toggling this on adds an entry named AITweaker to the registry key:

HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run

The value is the absolute path to run.bat in the application directory.Toggling it off deletes the AITweaker value from the same key. If the value does not exist (e.g. it was never set or was removed manually), the toggle handles this gracefully without error.

To remove the startup entry manually, open Registry Editor, navigate to HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run, and delete the AITweaker value.

On macOS, toggling this on creates a LaunchAgent plist file at:

~/Library/LaunchAgents/com.tweaker.app.plist

The plist sets RunAtLoad to true and points ProgramArguments to the absolute path of run.sh in the application directory.

com.tweaker.app.plist

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.tweaker.app</string>
    <key>ProgramArguments</key>
    <array>
        <string>/path/to/run.sh</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
</dict>
</plist>

Toggling it off deletes the plist file. macOS automatically stops launching the agent once the file is removed.

To remove the startup entry manually, delete ~/Library/LaunchAgents/com.tweaker.app.plist.

On Linux, toggling this on creates an XDG autostart desktop entry at:

~/.config/autostart/tweaker.desktop

The file points to the absolute path of run.sh and sets Terminal=false so no terminal window opens on login.

tweaker.desktop

[Desktop Entry]
Type=Application
Name=AI Tweaker
Exec=/path/to/run.sh
StartupNotify=true
Terminal=false

Toggling it off deletes tweaker.desktop. Most desktop environments (GNOME, KDE, XFCE) respect the XDG autostart spec and will stop launching the app once the file is gone.

To remove the startup entry manually, delete ~/.config/autostart/tweaker.desktop.

Get Started

AI Tweakers

Profiles & Settings

Guides

Configure system tray and OS startup for AI Leaks Tweaker

Minimize to tray

Start with OS

Build docs developers (and LLMs) love

Get Started

AI Tweakers

Profiles & Settings

Guides

Documentation Index

​Minimize to tray

​Start with OS

Build docs developers (and LLMs) love

Minimize to tray

Start with OS