{"id":13583642,"url":"https://github.com/webrecorder/webrecorder-desktop","last_synced_at":"2025-04-06T21:32:38.496Z","repository":{"id":54796764,"uuid":"180848584","full_name":"webrecorder/webrecorder-desktop","owner":"webrecorder","description":"Webrecorder Desktop App!","archived":true,"fork":false,"pushed_at":"2021-02-16T03:47:32.000Z","size":1534,"stargazers_count":205,"open_issues_count":32,"forks_count":23,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-03-28T03:26:19.723Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/webrecorder.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-04-11T17:53:41.000Z","updated_at":"2025-03-15T12:56:44.000Z","dependencies_parsed_at":"2022-08-14T03:10:28.881Z","dependency_job_id":null,"html_url":"https://github.com/webrecorder/webrecorder-desktop","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webrecorder%2Fwebrecorder-desktop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webrecorder%2Fwebrecorder-desktop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webrecorder%2Fwebrecorder-desktop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webrecorder%2Fwebrecorder-desktop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/webrecorder","download_url":"https://codeload.github.com/webrecorder/webrecorder-desktop/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247394978,"owners_count":20932043,"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":[],"created_at":"2024-08-01T15:03:40.294Z","updated_at":"2025-04-06T21:32:38.472Z","avatar_url":"https://github.com/webrecorder.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"**Deprecated** The Webrecorder Desktop App is now replaced by the [ArchiveWeb.page](https://archiveweb.page) system, available as an Electron App and Chrome Extension.\n\nThe new [Electron app](https://github.com/webrecorder/archiveweb.page/releases) is close to supporting all features of Webrecorder Desktop, and should work much better on latest Windows and OS X.\n\nThe [Chrome extension](https://chrome.google.com/webstore/detail/webrecorder-archivewebpag/fpeoodllldobpkbkabpblcfaogecpndd) version is compatible with all Chromium-based browsers, and allowing recording and replay directly in the browser.\n\nDevelopment for ArchiveWeb.page continues at: [https://github.com/webrecorder/archiveweb.page](https://github.com/webrecorder/archiveweb.page).\n\n\u003chr\u003e\n\n# Webrecorder Desktop App\n\nThe Webrecorder Desktop App is a complete packaging of [Webrecorder](https://github.com/webrecorder/webrecorder) hosted service as an Electron application, with an integrated Chromium browser.\n\nIt includes the same functionality available on Webrecorder.io running as a local app, including the\nnew [Autopilot](https://blog.webrecorder.io/2019/08/14/autopilot.html) feature.\n\nAll data captured is stored in a local directory on your machine, in `Webrecorder-Data` in your Documents directory.\n\nWebrecorder Desktop can be downloaded below or from [Releases](https://github.com/webrecorder/webrecorder-desktop/releases)\n\n| OS X | Windows (64-bit) | Windows (32-bit) | Linux |\n| --- | --- | --- | --- |\n| [.dmg](https://github.com/webrecorder/webrecorder-desktop/releases/download/v2.0.3/webrecorder-2.0.3.dmg) | [.exe (64-bit)](https://github.com/webrecorder/webrecorder-desktop/releases/download/v2.0.3/webrecorder-win-x86_64-2.0.3.exe) | [.exe (32-bit)](https://github.com/webrecorder/webrecorder-desktop/releases/download/v2.0.3/webrecorder-win-x86-2.0.3.exe) | [.AppImage](https://github.com/webrecorder/webrecorder-desktop/releases/download/v2.0.3/webrecorder-2.0.3.AppImage) |\n\n*Note: Running on Linux requires installation of Redis, available as a package on most distros.\nOS X and Windows versions come with a bundled version of Redis.*\n\n\u003cimg src=\"https://blog.webrecorder.io/assets/desktop-app.png\" width=\"400\" title=\"Desktop App\"\u003e\u003cimg src=\"https://blog.webrecorder.io/assets/desktop-capture.png\" width=\"400\" title=\"App Settings\"\u003e\n\n## Current Features\n\nIn addition to the core Webrecorder functionality, the desktop app includes additional features specific to the desktop environmentment. A few of these brand new features are still experimental or in beta, as listed below, so please let us know if anything is not working as expected!\n\n\n### Latest Chromium Browser with Flash Support\n\nLike Webrecorder Player, the Webrecorder Desktop app is built with Electron, and includes the latest release of Chromium, ensuring capture and replay is done with a modern browser. The app also includes a recent Flash plugin to allow for capture and replay of any Flash content. (The App Settings screen includes versions of all components).\n\n\n### Local Storage of All Data\n\nAll Webrecorder Data is stored in the `\u003cDocuments\u003e/Webrecorder-Data` directory, with actual WARC files under the storage subdirectory. The Autopilot behaviors are placed in the ‘behaviors’ subdirectory. The directory layout may be updated in the future as we work towards a more standardized directory format for web archives. \n\n\n### Capture, Replay \u0026 Curation\n\nThe app includes capture, replay, patching as well as curation and collection management features, same as those found on https://webrecorder.io. Existing collections can also be imported (as WARC files) and exported collections can be uploaded to https://webrecorder.io if desired.\n\n\n### Autopilot\n\nThe desktop app includes the full [Autopilot](https://guide.webrecorder.io/autopilot) capabilities for capture of certain dynamic websites, introduced with our last release. Unlike a regular browser, Webrecorder Desktop can run Autopilot in the background and be minimized without affecting the quality of Autopilot capture. For example, users can start Autopilot and have it run in the background while doing other work. (There is an option to mute audio in the Options menu for this use case). There is no limit to how long Autopilot can run locally, and only limits are available network bandwidth and disk storage!\n\n### Preview Mode (Beta)\n\nThe desktop app includes a new *Preview* mode that allows browsing content without capture. In particular, this can be used to preview a page before capturing it but also to log in to any sites that require login without capturing the login itself. \n\nAfter logging to a site in Preview mode, users can then switch to capture mode via the dropdown menu, beginning capture from after the login has completed.\n\n\u003cimg src=\"https://blog.webrecorder.io/assets/preview.png\" width=\"400\" title=\"Preview Mode\"\u003e\n\nThis workflow is recommended for capturing any sites that require a login. To reset all logins, there is also a “Clear Cookies” option in the Options menu. (This feature is currently in beta and we welcome any feedback on this!)\n\n\n### Mobile Device Emulation Mode (Experimental)\nThe desktop app also includes an experimental mobile device emulation mode, toggleable from the Options menu. With this mode, Webrecorder Desktop will act as a mobile browser and allow for capturing of mobile only content. The window can be resized as needed to support any mobile device. (This feature is currently in beta and we welcome any feedback on this!)\n\n\u003cimg src=\"https://blog.webrecorder.io/assets/mobile.png\" width=\"200\" title=\"Mobile Mode\"\u003e\n\n### DAT Protocol Support (Experimental)\n\nThe app includes our [previously-announced approach to sharing web archive collections](https://blog.webrecorder.io/2018/08/02/webrecorder-dat-integration.html) via the [Dat peer-to-peer protocol](https://dat.foundation/). To enable sharing of a collection, select `Share via Dat` from the collection menu.\nThe collection will then have a unique `dat://` url, which will allow the full collection (and future updates) to be synched using various tools that use the [Dat protocol](https://awesome.datproject.org/#using-dat), to allow for automated backup of local collections, if desired. There is not (yet) a way to import existing collections via Dat, but import is planned for a future update.\n\n\n### Capture Cache (Experimental)\n\nWhen browsing sites that share resources, Webrecorder Desktop enables the browser cache to avoid capturing\nthe same resources multiple times and writing them to WARC. The cache is reset per recording session,\nbut can also be cleared manually via the Options menu *Clear Cache* option. \nThe cache should reduce duplicates resources loaded over the network and speed up the browsing and thereby the capture process.\nThis feature is still experimental.\n\n\n### TOR Capture Support (Experimental)\n\nWebrecorder Desktop can capture web content over [Tor](https://torproject.org/), including Tor hidden services.\nHowever, this requires a bit of manual setup. A local Tor Relay must be [installed locally](https://2019.www.torproject.org/docs/installguide.html.en).\n\nThen, via a command-line, set `export SOCKS_HOST=localhost` before starting Webrecorder Desktop to have it use the Tor SOCKS proxy. Future versions may simplify this process.\n\n\n# Building Webrecorder Desktop\n\nTo build Webrecorder Desktop locally, please follow the instructions:\n\n1) Clone with submodules (the submodule is the main [webrecorder/webrecorder](https://github.com/webrecorder), which contains most of the code)\n\n```\ngit clone --recurse-submodules https://github.com/webrecorder/webrecorder-desktop.git\n```\n\nThis will install the Webrecorder submodule as well\n\n2) Build Webrecorder Python Binaries and install into `python-binaries`\n\nThis will build the Webrecorder project and install PyInstaller 3.3.\nPython 3.5 is recommended for now and a separate virtualenv just in case.\n\n\n```\n./build-wr.sh\n```\n\n3) Build the Webrecorder frontend\n\n```\nnode build-desktop.js\n```\n\n4) Run in Dev Mode\n\n```\nyarn run start-dev\n```\n\n5) Build Electron Binary\n\n\n```\nyarn run dist\n```\n\n6) If all goes well, the binary image should be placed in ``./dist/{mac,linux,win}`` directory, depending on your platform.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebrecorder%2Fwebrecorder-desktop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwebrecorder%2Fwebrecorder-desktop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebrecorder%2Fwebrecorder-desktop/lists"}