HyprSession is a utility designed to store and restore window sessions for Hyprland, a dynamic tiling window manager for Linux. Initially created using Bun.js, the tool is compiled into a binary for seamless usage on Linux systems.
hyprsession.mp4
Note
Most of it should work and depending on the window count it will take a while. This is through the nature of hyprland. Also please note applications like chromium (if you use multiple windows) or vesktop/vencord (if you need to login) will not be restored correctly. This will hopefully work in a future release.
- Save and Restore Sessions: Quickly save your current window layout and restore it later.
- Automatic Session Saving: Periodically save running sessions with customizable intervals.
-
Download the precompiled binary from the releases section.
-
Move the binary to a directory in your
PATH(e.g.,/usr/local/bin). -
Make it executable:
chmod +x /usr/local/bin/hyprsession
-
Add it to your hyprland.conf
exec-once = hyprsession # or exec-once = hyprsession --silent
$ hyprsession| Option | Alias | Description | Default |
|---|---|---|---|
--restore-session |
-r |
Restores the last session | |
--save-session |
-s |
Saves the current session | |
--auto-save |
-a |
Periodically save running sessions | true |
--interval |
-i |
Time between auto saves (in seconds) | 60 |
--silent |
-x |
Suppress all output to stdout | |
--debug |
-v |
Print debug logs | |
--help |
Shows help text |
$ hyprsession --save-session$ hyprsession --restore-session$ hyprsession --save-session --auto-save=falseHyprSession was initially developed with Bun.js and compiled into a binary. Contributions are welcome! Feel free to open issues or pull requests to improve the tool.
- Fix Chromium multi window issue
- Fix Vencord if login is needed
- Create, save and restore sessions by name
- Make it faster
This project is licensed under the GPL-3.0 License.