CLI wine manager
  • Python 99.3%
  • Shell 0.7%
Find a file
2026-05-08 21:04:37 -06:00
rpmbuild/SPECS Add WIP RPM packaging 2026-05-08 21:04:37 -06:00
LICENSE.md Relicense to GPL3 2026-05-08 21:04:24 -06:00
main.py Add API call for latest release 2026-05-08 21:04:09 -06:00
neutron Add runner management logic 2026-05-08 19:40:42 -06:00
README.md Add API call for latest release 2026-05-08 21:04:09 -06:00

Neutron - CLI Wine Manager

CLI to download and manage Proton and Wine versions, manage wine prefixes, and run them using bubblewrap

Features

  • Symlink Proton versions to use them in multiple launchers such as Steam and Bottles without taking extra space
  • More Proton versions available than ProtonPlus and ProtonUp-Qt, such as Spritz Wine
  • Download in parallel using aria2

Limitations

Currently only supports using the latest version of each wine, not older versions

Usage - manage Wine versions

Add Proton-EM to all targets

neutron runner add proton-em

Add a target to install all runners to

neutron target add steam-flatpak

Update all installed runners to latest version

neutron runner upgrade

Usage - run wine programs

neutron run [FILE PATH] - Runs in neutron's default prefix

neutron run [FILE PATH] --prefix mywineprefix

neutron run steam [GAME ID]

--no-bwrap / -b - Don't sandbox wine, in case the program needs to access your host system's files

--gamescope / -g - Run inside gamescope

--cage - Run inside of cage

--wayland / -w - Run using winewayland driver

--umu - Run wine inside of umu-launcher (this will happen regardless of this flag for Proton-based runners)

--no-umu - Run the proton executable directly without Steam Runtime

--no-network / -n - Disable network access (not compatible with --no-bwrap)

Usage - manage prefixes

neutron prefix add mywineprefix --runner proton-em

neutron prefix delete mywineprefix

neutron prefix change-runner mywineprefix proton-em

neutron prefix config mywineprefix - Run winecfg

neutron prefix files mywineprefix - Open prefix folder in default file manager

neutron prefix list

neutron prefix winetricks mywineprefix - Run winetricks/protontricks for your prefix

Future plans

  • Nix declarative prefix creation, with first-run installer executable support
  • GUI