{"id":19903733,"url":"https://github.com/regolith-linux/i3-snapshot","last_synced_at":"2025-07-31T11:42:52.184Z","repository":{"id":45975994,"uuid":"190961051","full_name":"regolith-linux/i3-snapshot","owner":"regolith-linux","description":"Record and restore window and workspace containment structure in i3-wm.","archived":false,"fork":false,"pushed_at":"2025-02-21T17:35:36.000Z","size":28,"stargazers_count":17,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-30T09:55:36.150Z","etag":null,"topics":["i3wm"],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/regolith-linux.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-06-09T03:45:46.000Z","updated_at":"2025-02-21T17:35:38.000Z","dependencies_parsed_at":"2024-11-05T21:03:21.008Z","dependency_job_id":"4aa067a5-adcb-4a46-9ae0-766f73ec4c55","html_url":"https://github.com/regolith-linux/i3-snapshot","commit_stats":{"total_commits":12,"total_committers":1,"mean_commits":12.0,"dds":0.0,"last_synced_commit":"5135c860ef4ebd02ef31e5116502ca8d69f392d3"},"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"purl":"pkg:github/regolith-linux/i3-snapshot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/regolith-linux%2Fi3-snapshot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/regolith-linux%2Fi3-snapshot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/regolith-linux%2Fi3-snapshot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/regolith-linux%2Fi3-snapshot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/regolith-linux","download_url":"https://codeload.github.com/regolith-linux/i3-snapshot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/regolith-linux%2Fi3-snapshot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268031446,"owners_count":24184464,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-31T02:00:08.723Z","response_time":66,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["i3wm"],"created_at":"2024-11-12T20:25:07.682Z","updated_at":"2025-07-31T11:42:52.106Z","avatar_url":"https://github.com/regolith-linux.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# i3-snapshot\nSave and restore window and workspace layout within an i3wm instance.\n\n## Usage\n\ni3-snapshot has two modes: \n\n* record: read i3 current state and emit to stdout\n`i3-snapshot \u003e snapshot.txt`\n* restore: modify the i3 window state from a previous configuration.\n`i3-snapshot \u003c snapshot.txt`\n  \n## Notes\n\nThis program is intended to be used when window layouts are mangled by display hotplug events or other changes that cause i3wm to restructure the containment layout.\n\ni3-snapshot employs a 'best effort' and 'fail-fast' strategy.  This means that it does little validation and aborts execution upon any failure.\n\nThe output is meant to be somewhat human readable for basic troubleshooting purposes.\n\ni3-snapshot is not an alternative to i3-save-tree.  i3-save-tree is for long-lived workspace structures that are to be populated by users interactively.  i3-snapshot only works within a single i3wm instance because it uses the internal ids to reference specific windows.  This means that a snapshot cannot be used after the i3wm session it was recorded in exits. \n\n## Example\n\nTo save your current window and workspace layout to a file:\n```\n$ i3-snapshot \u003e layout.txt\n```\n\nTo restore a layout from a file:\n```\n$ i3-snapshot \u003c layout.txt\n```\n\n## Adding to an i3 config\n\nBind i3-snapshot to keys such that layouts can be saved and restored like this:\n\n```\nbindsym $mod+comma  exec /usr/local/bin/i3-snapshot -o \u003e /tmp/i3-snapshot.txt \nbindsym $mod+period exec /usr/local/bin/i3-snapshot -c \u003c /tmp/i3-snapshot.txt \n```\n\n## Install\n\nA Debian package `i3-snapshot` for Ubuntu is available at `ppa:kgilmer/speed-ricer` for Bionic, Disco, and Eoan releases.\n\n## How to build\n\nDirect dependencies are integrated via git submodules.  Additionally, the i3/ipc.h header file from the i3 package, `libjsoncpp-dev`, and `libsigc++-2.0-dev` are required.\n\n```\n$ git clone https://github.com/regolith-linux/i3-snapshot.git\n...``\n$ cd i3-snapshot\n...\n$ git submodule init\n$ git submodule update\n$ mkdir build \u0026\u0026 cd build\n$ cmake ..\n$ make\n...\n$ ./i3-snapshot\n```\n\n### and install \n\n```\nsudo cp i3-snapshot /usr/local/bin/\n```\n\n## Expectation of quality\n\ni3-snapshot should be considered alpha quality.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fregolith-linux%2Fi3-snapshot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fregolith-linux%2Fi3-snapshot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fregolith-linux%2Fi3-snapshot/lists"}