{"id":13535872,"url":"https://github.com/emuell/restic-browser","last_synced_at":"2025-05-15T05:06:12.249Z","repository":{"id":39533790,"uuid":"506162055","full_name":"emuell/restic-browser","owner":"emuell","description":"A GUI to browse and restore restic backup repositories.","archived":false,"fork":false,"pushed_at":"2025-01-08T09:06:47.000Z","size":4718,"stargazers_count":846,"open_issues_count":27,"forks_count":23,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-04-14T08:11:29.679Z","etag":null,"topics":["lit-element","mobx","restic","tauri","tauri-app","vaadin","web-components"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"leaanthony/restoric","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/emuell.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}},"created_at":"2022-06-22T08:29:33.000Z","updated_at":"2025-04-13T16:14:16.000Z","dependencies_parsed_at":"2024-03-18T10:25:58.775Z","dependency_job_id":"1b5407c1-aa1c-4bd8-9178-9794e08ddb47","html_url":"https://github.com/emuell/restic-browser","commit_stats":{"total_commits":218,"total_committers":8,"mean_commits":27.25,"dds":"0.050458715596330306","last_synced_commit":"2a74ad78f86d1e7c16020ea852fdf76b954c4812"},"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emuell%2Frestic-browser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emuell%2Frestic-browser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emuell%2Frestic-browser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emuell%2Frestic-browser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/emuell","download_url":"https://codeload.github.com/emuell/restic-browser/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254276447,"owners_count":22043867,"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","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":["lit-element","mobx","restic","tauri","tauri-app","vaadin","web-components"],"created_at":"2024-08-01T09:00:30.864Z","updated_at":"2025-05-15T05:06:08.847Z","avatar_url":"https://github.com/emuell.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","Apps"],"sub_categories":[],"readme":"\u003cimg src=\"./src/assets/images/eye.png\" alt=\"drawing\" height=\"48px\"/\u003e \u003cimg src=\"./src/assets/images/logo.png\" alt=\"drawing\" height=\"48px\"/\u003e \n\n---\n\nA simple, cross-platform [restic backup](https://github.com/restic/restic) GUI for browsing and restoring restic repositories. \n\nBuilt with [Tauri](https://tauri.app), based on leaanthony's [Restoric](https://github.com/leaanthony/restoric) PoC. \n\nOlder versions of the restic browser were built using [Wails2](https://wails.io). The latest release based on Wails is [v0.2.6](https://github.com/emuell/restic-browser/releases/tag/v0.2.6). \n\n## Download\n\nPrebuilt binaries can be downloaded from the [GitHub releases](https://github.com/emuell/restic-browser/releases) page.\n\n\n## Features\n\nThis is not a fullblown restic backup GUI - it only allows you to *browse* existing repositories!\n\n* *Displays* contents (snapshots, files) from local and remote restic repositories.\n* *Dumps* selected files or folders (as a zip archive) to a desired location.\n* *Restores* selected files or folders to a desired location.\n* *Opens* selected files by moving them to TEMP, then opens them with your operating system's default programs.\n\n![Screenshot](./screenshot.png \"Restic Browser\")\n\n\n## Keyboard Navigation\n\nThe UI is navigatable via keyboard shortcuts. To change the focus area, hit `Tab` + `Shift-Tab` keys.\n\n### Global Shortcuts: \n\n- `Control/CMD + O`: Open new repository\n\n### Snapshot-List\n- `Arrow keys`, `Page Up/Down`, `Home/End`: Change selected snapshot\n\n### File-List\n- `Arrow keys`, `Page Up/Down`, `Home/End`: Change selected file\n- `o` or `Enter` or `Space`: Open selected file or folder\n- `d`: Dump selected file or folder as zip file\n- `r`: Restore selected file or folder\n\n\n## Arguments\n\n### Usage\n```\nRestic-Browser [OPTIONS]\n```\n\n### Options\n```\n-h, --help\n    Print help information\n\n--insecure-tls\n    skip TLS certificate verification when connecting to the repo (insecure)\n\n--password \u003cpassword\u003e\n    password for the repository - NOT RECOMMENDED - USE password-file/command instead. (default: $RESTIC_PASSWORD)\n\n--password-command \u003cpassword-command\u003e\n    shell command to obtain the repository password from (default: $RESTIC_PASSWORD_COMMAND)\n  \n--password-file \u003cpassword-file\u003e\n    file to read the repository password from (default: $RESTIC_PASSWORD_FILE)\n\n-r, --repo \u003crepo\u003e\n    repository to show or restore from (default: $RESTIC_REPOSITORY)\n\n--rclone \u003crclone\u003e\n    ABS path to the rclone executable that should be used for rclone locations. (default: 'rclone')\n\n--repository-file \u003crepository-file\u003e\n    file to read the repository location from (default: $RESTIC_REPOSITORY_FILE)\n\n--restic \u003crestic\u003e\n    ABS path to the restic executable that should be used. (default: find in $PATH)\n\n-V, --version\n    Print version information\n```\n\n## System Requirements\n\n#### All platforms\n- Install [restic](https://github.com/restic/restic/releases/) and *make sure it is included in your $PATH*.\u003cbr /\u003e\n  On MacOS, where setting the PATH for desktop applications is a really hard thing to do, the restic executable will also be found if it's in one of the following folders: `/usr/local/bin, /opt/local/bin, /opt/homebrew/bin, ~/bin`.\n\n#### Windows:\n- Windows 10 or later with [WebView2 Runtime](https://developer.microsoft.com/microsoft-edge/webview2/#download-section)\n\n#### MacOS:\n- macOS 10.13 or later\n\n#### Linux:\n- Linux with GLIBC_2.31 or later (e.g. Ubuntu 20.04 or later)\n- WebKit2 (install via `apt install libwebkit2gtk-4.0` on Ubuntu)\n- Try using the Linux appimage from the prebuilt releases, in case libwebkit2gtk-4.0 is not available on your system.\n\n## Development\n\n### Dependencies\n\n* Follow the [Tauri Prerequisites Docs](https://tauri.app/v1/guides/getting-started/prerequisites/) to install a *C/C++ toolchain* and *Rust* 1.78 or later for your platform.\n* Make sure [npm](https://nodejs.org/en/download) *Node* 18 LTS or later is installed.\n* Install [restic](https://github.com/restic/restic/releases/) and make sure it is included in your $PATH. \n  \nNote: installing the tauri CLI via cargo is not necessary. Tauri can be launched through npm (see below). \n\n### Front-end and App Development\n\nTo work in live development mode with automatic hot-reloading, run `npm run tauri dev` in the root directory. \n\n### Rust Backend Debugging\n\nTo debug the Tauri Rust application code, you can use the included startup tasks of vscode. If you press \"F5\" in vscode, the application will be built in debug mode and then started.   \n\n### Building Production Packages\n\nTo build a redistributable package in production mode, run `npm run tauri build` in the root directory.\n\n\n## License\n\nMIT license. See [LICENSE](./LICENSE) for the full text.\n\n\n## Contribute\n\nPatches are welcome! Please fork the latest git repository and create a feature branch. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femuell%2Frestic-browser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Femuell%2Frestic-browser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femuell%2Frestic-browser/lists"}