{"id":21836035,"url":"https://github.com/0negal/viper","last_synced_at":"2025-04-04T14:07:14.571Z","repository":{"id":38006800,"uuid":"441579129","full_name":"0neGal/viper","owner":"0neGal","description":"Launcher+Updater for TF|2 Northstar","archived":false,"fork":false,"pushed_at":"2025-01-02T22:05:16.000Z","size":20303,"stargazers_count":155,"open_issues_count":11,"forks_count":20,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-03-28T13:08:14.737Z","etag":null,"topics":["launcher","modding","northstar","northstar-client","r2northstar","titanfall","titanfall-2","updater"],"latest_commit_sha":null,"homepage":"https://0negal.github.io/viper","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0neGal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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},"funding":{"liberapay":"0neGal","custom":["github.com/R2Northstar"]}},"created_at":"2021-12-25T00:45:42.000Z","updated_at":"2025-03-04T15:17:16.000Z","dependencies_parsed_at":"2022-08-08T22:45:54.276Z","dependency_job_id":"e86213b6-728d-40aa-9e2c-a1d969aaf10b","html_url":"https://github.com/0neGal/viper","commit_stats":null,"previous_names":[],"tags_count":44,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0neGal%2Fviper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0neGal%2Fviper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0neGal%2Fviper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0neGal%2Fviper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0neGal","download_url":"https://codeload.github.com/0neGal/viper/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247190250,"owners_count":20898702,"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":["launcher","modding","northstar","northstar-client","r2northstar","titanfall","titanfall-2","updater"],"created_at":"2024-11-27T20:32:53.025Z","updated_at":"2025-04-04T14:07:14.553Z","avatar_url":"https://github.com/0neGal.png","language":"JavaScript","readme":"\u003cp align=\"center\"\u003e\n\t\u003cimg src=\"src/assets/icons/512x512.png\" width=\"200px\"\u003e\u003cbr\u003e\n\t\u003ca href=\"https://0negal.github.io/viper/index.html?win-setup\"\u003e\u003cimg src=\"assets/download.png\" width=\"300px\"\u003e\u003c/a\u003e\u003cbr\u003e\n\t\u003ca href=\"FAQ.md\"\u003eFAQ\u003c/a\u003e | \n\t\u003ca href=\"CONTRIBUTING.md\"\u003eContributing\u003c/a\u003e | \n\t\u003ca href=\"https://github.com/0neGal/viper/releases\"\u003eReleases\u003c/a\u003e\u003cbr\u003e\n\u003c/p\u003e\n\n## What is Viper?\n\nViper is a launcher and updater for [Northstar](https://github.com/R2Northstar/Northstar), and not much more than that.\n\n## Install\n\nDownloads are available on the [releases page](https://github.com/0neGal/viper/releases/latest). \n\nPlease note that some versions will update themselves automatically when a new release is available (just like Origin or Steam) and some will NOT, so choose it accordingly. Only the AppImage, Flatpak and Windows Setup/Installer can auto-update.\n\n**Windows:** [`Viper Setup [x.y.z].exe`](https://0negal.github.io/viper/index.html?win-setup) (auto-updates, and is recommended), [`Viper [x.y.z].exe`](https://0negal.github.io/viper/index.html?win-portable) (single executable, no fuss)\n\n**Linux:** [`.AppImage`](https://0negal.github.io/viper/index.html?appimage) or [Flatpak](https://flathub.org/apps/details/com.github._0negal.Viper) (auto-updates), [AUR (unofficial)](https://aur.archlinux.org/packages/viper-bin), [`.deb`](https://0negal.github.io/viper/index.html?deb), [`.rpm`](https://0negal.github.io/viper/index.html?rpm), [`.tar.gz`](https://0negal.github.io/viper/index.html?linux)\n\n\u003ca href=\"https://github.com/0neGal/viper/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/0neGal/viper\" alt=\"GitHub release (latest by date)\"\u003e\u003c/a\u003e\n\u003cimg src=\"https://img.shields.io/github/downloads/0neGal/viper/latest/total\" alt=\"GitHub release downloads (latest by date)\"\u003e\n\u003cimg src=\"https://img.shields.io/flathub/downloads/com.github._0negal.Viper?label=Flathub%20installs\" alt=\"Flathub installs (Total)\"\u003e\n\n## What can it do specifically?\n\n\u003cp\u003e\nCurrently Viper is capable of:\n\n\u003cimg src=\"assets/ns-launch.png\" align=\"right\" width=\"50%\"\u003e\n\n * Updating/Installing Northstar\n * Launching Vanilla and or Northstar\n * Manage Mods\n * Auto-Update itself \n * Be pretty!\n\nThere are of course many other things that it can do, but summed up very simply, that is what Viper is capable of doing. With every update Viper gets more features and alike, often many optional features are also available in the settings menu.\n\n\u003c/p\u003e\n\n## Configuration\n\nAll settings take place in the settings page, found in the top right corner of the app, where you can change all kinds of settings. You can also manually go in and edit your config file (`viper.json`), if you feel so inclined.\n\nYour configuration file will be found in `%APPDATA%\\viper.json` on Windows, and inside either `~/.config` or through your environment variables (`$XDG_CONFIG_HOME`) on Linux, the latter has priority.\n\n## Support\n\nTo get support please [open a GitHub issue](https://github.com/0neGal/viper/issues/new/choose), and clearly describe the problem with as many details as possible.\n\n### Frequently Asked Questions (FAQ)\n\nMany of the questions and problems you may have might be able to be answered by reading the [FAQ page](FAQ.md). So before opening an issue or asking for support please read through it first!\n\n## Sidenote\n\nGiven that we already have so many Northstar updaters and launchers I urge people to instead of creating new launchers unless there's a very specific reason, just make a pull request on one of the existing ones, otherwise we'll continue to have new ones.\n\n\u003cp align=\"center\"\u003e\n\tRelevant xkcd:\u003cbr\u003e\n\t\u003cimg src=\"assets/xkcd.png\"\u003e\n\u003c/p\u003e\n\nSome of the existing launchers are listed below:\n * Viper - A launcher, updater and mod manager with an easy to use GUI\n * [FlightCore](https://github.com/R2NorthstarTools/FlightCore) - A more minimal GUI manager and updater, with similar features to Viper\n * [ViperSH](https://github.com/0neGal/viper-sh) - A Bourne Shell, CLI only, Northstar updater and mod manager\n * [VTOL](https://github.com/BigSpice/VTOL) - an updater and manager for mods, very feature rich\n * [r2modman](https://github.com/ebkr/r2modmanPlus) - General purpose mod manager, which has support for Northstar\n * [Papa](https://github.com/AnActualEmerald/papa) - a CLI only installer, updater, and mod manager\n * [FIITE](https://github.com/EladNLG/FastestInstallerInTheEast) - a minimalistic CLI installer and updater.\n\n## Development\n\nIf you wanna edit Viper's code, run it, and so on, you can simply do something along the lines of the below:\n\n```sh\n$ git clone https://github.com/0neGal/viper\n\n$ cd viper\n\n$ npm i\n\n$ npm run start\n```\n\nThis'll launch it with the Electron build installed by `npm`.\n\nAdditionally, if you're creating your own fork you easily publish builds and or make builds with either `npm run publish` or `npm run build` respectively, the prior requiring a `$GH_TOKEN` to be set, as it creates the release itself so it needs a token with access to your repo. So you'd do something along the lines of:\n\n```sh\n$ GH_TOKEN=\"\u003cyour very long, private and wonderful token\u003e\" npm run publish\n```\n\nKeep in mind building all Linux builds may take a while on some systems, as packaging the `tar.gz` release can take a while on many CPUs, at least from my testing. All other builds should be done quickly. When using the `publish` command it also automatically uploads the needed files to deploy auto-updates, keep in mind you'd need to have the `repository` setting changed to your new fork's location, otherwise it'll fetch from the original.\n\n## Credits\n\n\u003ca href=\"https://github.com/0neGal/viper/graphs/contributors\"\u003e\n\t\u003cimg src=\"https://contrib.rocks/image?repo=0neGal/viper\" /\u003e\n\u003c/a\u003e\n\n**Logo:** Imply#9781\u003cbr\u003e\n**Viper Background:** [Uber Panzerhund](https://www.reddit.com/r/titanfall/comments/fwuh2x/take_to_the_skies)\u003cbr\u003e\n**Titanfall+Northstar Logo:** [Aftonstjarma](https://www.steamgriddb.com/logo/47851)\n","funding_links":["https://liberapay.com/0neGal","github.com/R2Northstar"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0negal%2Fviper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0negal%2Fviper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0negal%2Fviper/lists"}