{"id":13961797,"url":"https://github.com/FlashpointProject/launcher","last_synced_at":"2025-07-21T06:31:49.108Z","repository":{"id":37979098,"uuid":"151470271","full_name":"FlashpointProject/launcher","owner":"FlashpointProject","description":"Launcher for Flashpoint Archive","archived":false,"fork":false,"pushed_at":"2025-07-12T16:42:53.000Z","size":46216,"stargazers_count":1095,"open_issues_count":78,"forks_count":58,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-07-18T04:22:56.191Z","etag":null,"topics":["desktop-app","desktop-application","electron","launcher","linux","windows"],"latest_commit_sha":null,"homepage":"https://flashpointarchive.org","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FlashpointProject.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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":"2018-10-03T19:40:47.000Z","updated_at":"2025-07-17T22:02:56.000Z","dependencies_parsed_at":"2023-02-18T13:46:34.048Z","dependency_job_id":"3a872aa3-eb4d-4dbf-9154-7e58a6ae8985","html_url":"https://github.com/FlashpointProject/launcher","commit_stats":{"total_commits":1861,"total_committers":25,"mean_commits":74.44,"dds":0.508328855454057,"last_synced_commit":"9e768b23ed1bb025e6342863841d263e74127879"},"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"purl":"pkg:github/FlashpointProject/launcher","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlashpointProject%2Flauncher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlashpointProject%2Flauncher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlashpointProject%2Flauncher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlashpointProject%2Flauncher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FlashpointProject","download_url":"https://codeload.github.com/FlashpointProject/launcher/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlashpointProject%2Flauncher/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266253576,"owners_count":23900052,"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":["desktop-app","desktop-application","electron","launcher","linux","windows"],"created_at":"2024-08-08T17:01:27.399Z","updated_at":"2025-07-21T06:31:44.090Z","avatar_url":"https://github.com/FlashpointProject.png","language":"TypeScript","readme":"# Flashpoint Launcher\nThe launcher for Flashpoint Archive (the non-profit web preservation project).\n\n![Screenshot](https://user-images.githubusercontent.com/10117720/55276674-a24e8c80-52f6-11e9-8b59-4fb396c36026.png)\n\n### Status\n\n[![Release Status](https://github.com/FlashpointProject/launcher/workflows/Release%20Status/badge.svg)](https://github.com/FlashpointProject/launcher)\n[![Build Status](https://github.com/FlashpointProject/launcher/workflows/Build%20Status/badge.svg)](https://github.com/FlashpointProject/launcher)\n[![Coverage Status](https://coveralls.io/repos/github/FlashpointProject/launcher/badge.svg?branch=master)](https://coveralls.io/github/FlashpointProject/launcher?branch=master)\n[![Crowdin](https://badges.crowdin.net/flashpoint-launcher/localized.svg)](https://crowdin.com/project/flashpoint-launcher)\n\n### Links\n* [Flashpoint Archive](http://flashpointarchive.org) - Download Flashpoint here (the launcher is bundled with it)\n* [Donate](https://opencollective.com/flashpointarchive) - Funds go towards the Flashpoint Archive non-profit to sustain archival efforts, not to fund developers of the launcher.\n\n## About\nThe Flashpoint Launcher (FPL) is a desktop application made for browsing, storing and launching other applications (games, animations, web apps etc.). It is specifically made for Flashpoint Archive, a non-profit with the goal of furthering archival and accessibility efforts for games, animations and other digital interactive experiences on the web.\n\nSee the `docs` folder for more information on setting up Flashpoint and Extension authoring.\n\nExtension API Documentation: https://flashpointproject.github.io/launcher_ApiDocs/\n\n## Building from source\n\n### External Dependencies\n\n#### Dependencies\n* [Git](https://git-scm.com/downloads) (for downloading and updating the source code and sub-modules)\n* [Node \u0026 NPM](https://nodejs.org/en/download/) (for building and running the source code)\n\n#### Linux Dependencies\n* `libgtk-3-0`\n* `libnss3`\n\nFollow Development Setup, using ``master`` branch for a stable release or ``develop`` for the latest features. After setup is complete, run ``npm run release`` to generate release builds in ``/dist``.\n\nInstall by running ``sudo apt install libgtk-3-0 libnss3``\n\n### Development Setup\n\n1. Clone the repository with ``git clone --branch develop --recurse-submodules https://github.com/FlashpointProject/launcher.git launcher`` (where ``launcher`` is the path of the directory you want to be the root of the repository).\n\n2. Navigate to the root of the repository and run ``npm install`` - this will download and install all the dependencies from npm (it may take a few minutes).\n\n3. Run ``npm run build`` or ``npm run watch`` (at the root of the repository). This will compile the source code and such so the launcher can be executed. If ``watch`` is used, it will rebuild the launcher automatically when a source code or static file is changed.\n\n4. Run ``npm run start`` (at the root of the repository) to start the launcher. It is recommended to do this in a second command prompt / terminal.\n\n5. **Optional** - It is highly recommended to set the launcher's \"Flashpoint folder\". This is where the launcher will read and write most data to and from. You can set the \"Flashpoint folder\" path at the \"Config\" tab in the launcher. Make sure the background of the text field is green (this means the path is valid) and don't forget to hit \"Save and Exit\"!\n\nNotes:\n\n* You will need to run ``npm install`` whenever a dependency is added or upgraded in ``package.json``.\n* The launcher is changing rapidly and does not always support older \"Flashpoint folders\". Sometimes it does not even support the most recent one.\n* It is recommended to have a separate \"Flashpoint folder\" for launcher development than normal usage.\n\n## Package Scripts\nShort descriptions of what the scripts in ``package.json`` do:\n\n* ``build`` - Build the launcher (build main \u0026 renderer and copy static files to ``./build/``)\n* ``watch`` - Build the launcher and incrementally rebuild it when the source or static files change\n* ``pack`` - Pack the latest build (and put the packaged file with the executable electron app in ``./dist/``)\n* ``snapshot`` - Build then pack the launcher (same as running ``build`` then ``pack``)\n* ``release`` - Build then pack the launcher in release mode (same as ``snapshot`` but it also creates installers, build artifacts etc.)\n* ``start`` - Run the latest build of the launcher\n* ``test`` - Run the test suite (to find out if anything covered by the tests has been broken)\n* ``lint`` - Run the linter\n\n``pack`` / ``snapshot`` / ``release`` will by default pack for the OS and architecture of the machine that runs it.\n\nTo pack for a specific OS / architecture use the handy package scripts (such as ``pack:linux`` or ``release:win32``) or set the environment variables ``PACK_PLATFORM`` / ``PACK_ARCH``.\n\n## Troubleshooting\n\n### \"Not allowed to load local resource\" Error\nIf this error appears in the electron applications console, it is probably because the file it is looking for does not exist. To solve this, run ``npm run build``\n\nExample: ``Not allowed to load local resource: file:///\u003cProjectPath\u003e/build/renderer/index.html``\n","funding_links":["https://opencollective.com/flashpointarchive"],"categories":["TypeScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFlashpointProject%2Flauncher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FFlashpointProject%2Flauncher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFlashpointProject%2Flauncher/lists"}