Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/gumieri/sway-session

Tool for saving the state of the Sway WM session and restoring it
https://github.com/gumieri/sway-session

desktop session sway swaywm

Last synced: 2 months ago
JSON representation

Tool for saving the state of the Sway WM session and restoring it

Host: GitHub
URL: https://github.com/gumieri/sway-session
Owner: gumieri
License: mit
Created: 2019-11-25T05:09:16.000Z (about 5 years ago)
Default Branch: master
Last Pushed: 2022-10-12T07:49:49.000Z (over 2 years ago)
Last Synced: 2024-10-29T20:27:59.483Z (2 months ago)
Topics: desktop, session, sway, swaywm
Language: Go
Homepage:
Size: 22.5 KB
Stars: 49
Watchers: 5
Forks: 2
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# sway-session

Tool for saving the state of the [Sway WM](https://swaywm.org) session and restoring it.

**At the moment, it is a [PoC](https://en.wikipedia.org/wiki/Proof_of_concept)!**

[![Actions Status](https://github.com/gumieri/sway-session/workflows/Go/badge.svg)](https://github.com/gumieri/sway-session/actions)
[![Go Report Card](https://goreportcard.com/badge/github.com/gumieri/note)](https://goreportcard.com/report/github.com/gumieri/note)
[![GoDoc](https://godoc.org/github.com/gumieri/sway-session?status.svg)](https://godoc.org/github.com/gumieri/sway-session)

## Usage
For saving the running programs and its workspace disposition run the given command:
```bash
sway-session save
```
It will create a json file at `$XDG_DATA_HOME/sway-session/sessions/`.

To restore simply use:
```bash
sway-session restore
```
The recomendation would be to place at the sway config file something like that:
```config
exec sway-session restore
```

There is a command for constantly save your session:
```bash
sway-session save-loop 120
```
It will save your session every 2 minutes, informed in seconds. If the seconds are not informed it will assume the default value, which is 1 minute.

The recomendation way to use it would be something like:
```config
exec sway-session restore && sway-session save-loop
```

## Supported programs
Considering that a lot of programs have different ways of retrieving it state and restoring it to the desired state,
the `sway-session` can only offer a generic approach for all the ecosystem and for more specific programs (like terminal-emulators)
to offer some rules with more capabilities.

### → [alacritty](https://github.com/jwilm/alacritty)
* current working directory