{"id":25219415,"url":"https://github.com/ascendara/ascendara","last_synced_at":"2026-04-01T18:43:06.333Z","repository":{"id":242999855,"uuid":"805154255","full_name":"Ascendara/ascendara","owner":"Ascendara","description":"Skip extracting files, navigating setup processes, or any unnecessary hassles.","archived":false,"fork":false,"pushed_at":"2026-02-04T21:11:29.000Z","size":70755,"stargazers_count":225,"open_issues_count":17,"forks_count":20,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-02-05T09:28:09.164Z","etag":null,"topics":["api","fitgirl","javascript","python","steam"],"latest_commit_sha":null,"homepage":"https://ascendara.app/contributors","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Ascendara.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"ascendara","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2024-05-24T01:51:56.000Z","updated_at":"2026-02-03T09:19:09.000Z","dependencies_parsed_at":"2024-07-07T10:23:34.663Z","dependency_job_id":"42f31a30-0cb3-4320-a69e-7596b116c5fc","html_url":"https://github.com/Ascendara/ascendara","commit_stats":null,"previous_names":["tagoworks/ascendara","ascendara/ascendara"],"tags_count":89,"template":false,"template_full_name":null,"purl":"pkg:github/Ascendara/ascendara","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ascendara%2Fascendara","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ascendara%2Fascendara/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ascendara%2Fascendara/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ascendara%2Fascendara/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ascendara","download_url":"https://codeload.github.com/Ascendara/ascendara/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ascendara%2Fascendara/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29135916,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-05T21:59:57.939Z","status":"ssl_error","status_checked_at":"2026-02-05T21:59:57.628Z","response_time":65,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["api","fitgirl","javascript","python","steam"],"created_at":"2025-02-10T21:08:45.507Z","updated_at":"2026-04-01T18:43:06.327Z","avatar_url":"https://github.com/Ascendara.png","language":"JavaScript","funding_links":["https://ko-fi.com/ascendara"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n    \u003cimg align=\"center\" width=\"128\" height=\"128\" src=\"./src/public/icon.png\" alt=\"Ascendara Logo\"\u003e\n    \u003ch1\u003eAscendara\u003c/h1\u003e\n    \u003cp\u003e\u003cem\u003eThe best way to test games before you buy them.\u003c/em\u003e\u003c/p\u003e\n    \u003cp\u003e\n        \u003ca href=\"https://discord.gg/ap6W3xMTKW\"\u003e\u003cimg src=\"https://img.shields.io/discord/939249162887766139?color=7289da\u0026label=discord\u0026logo=discord\u0026logoColor=white\" alt=\"Discord\"\u003e\u003c/a\u003e\n        \u003ca href=\"https://github.com/tagoWorks/ascendara/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/tagoWorks/ascendara?include_prereleases\u0026label=latest%20release\" alt=\"Latest Release\"\u003e\u003c/a\u003e\n         \u003cimg src=\"https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Flfs.ascendara.app%2Fcount%2Fdownloads\u0026query=downloads\u0026style=flat\u0026label=download%20count\" alt=\"Download Count\"\u003e\n        \u003ca href=\"./LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-CC%20BY--NC%201.0-green\" alt=\"License\"\u003e\u003c/a\u003e\n    \u003c/p\u003e\n    \u003cp\u003e\n        \u003ca href=\"https://github.com/tagoWorks/ascendara/issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues-raw/tagoWorks/ascendara\" alt=\"Issues\"\u003e\u003c/a\u003e\n        \u003cimg src=\"https://img.shields.io/github/last-commit/tagoWorks/ascendara\" alt=\"Last Commit\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/ascendara/ascendara/build.yml\" alt=\"Build Status\"\u003e\n        \u003ca href=\"https://github.com/tagoWorks/ascendara/network/members\"\u003e\u003cimg src=\"https://img.shields.io/github/forks/tagoWorks/ascendara?style=flat\u0026logo=github\u0026logoColor=white\" alt=\"Forks\"\u003e\u003c/a\u003e\n        \u003ca href=\"https://github.com/tagoWorks/ascendara/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/tagoWorks/ascendara?style=social\" alt=\"GitHub Stars\"\u003e\u003c/a\u003e\n    \u003c/p\u003e\n\u003c/div\u003e\n\n## 🎮 About\n\nAscendara simplifies your game management experience by providing a seamless way to discover, organize, and test pre-installed games. No more hassle with extracting, installing, or moving files. The game library is powered by a custom webscraper, currently featuring titles mainly from [STEAMRIP](https://ascendara.app/sources/steamrip) with plans to expand to more sources and is available on both Windows and Linux platforms.\n\n### 🔗 Quick Links\n\n- [Join the Discord](https://ascendara.app/discord) for discussions and support\n- [Submit feedback for Ascendara](https://ascendara.app/feedback)\n- [Contribute to Ascendara](https://github.com/tagoWorks/ascendara)\n- [Read the latest changelog](https://ascendara.app/changelog)\n- [Learn about Ascend](https://ascendara.app/ascend)\n- [Check latest releases on Github](https://github.com/tagoWorks/ascendara/releases)\n\n## ✨ Features\n\n- 🚀 **Seamless Downloads**\n\n  Lightning-fast 2 click download for games that support it. No browser needed at all.\n\n- ☁️ **Cloud Backups**\n\n  Upload game backup files to a secure Cloudflare storage system for safekeeping.\n\n- 🔌 **Game Information**\n\n  View game info, including the game's story, soundtrack, and more with Ascendara Xtra.\n\n- 🌐 **Browser Integration**\n\n  Seamlessly integrate with your browser for one-click game downloads and management.\n\n- 🎨 **Theme Customization**\n\n  Beautiful, appealing themes to choose from for a truly unique experience.\n\n- 🕑 **Local Indexing**\n\n  Search for games at crazy speeds and always stay up to date.\n\n- 📱 **Encrypted Remote Access**\n\n  View download progression from anywhere, all data is end-to-end encrypted.\n  \n- 🌍 **105 Languages Support**\n\n  Full interface support for 105 different languages, making Ascendara accessible worldwide.\n\n\u003cdetails\u003e\n\u003csummary\u003eSee the 12 base languages\u003c/summary\u003e\n\nThese languages come with the app by default:\n\n- English\n- Spanish\n- French\n- German\n- Italian\n- Chinese\n- Arabic\n- Hindi\n- Bengali\n- Portuguese\n- Russian\n- Japanese\n\n\u003cdetails\u003e\n\u003csummary\u003eWant to see the full list?\u003c/summary\u003e\n\n- Afrikaans\n- Albanian\n- Amharic\n- Armenian\n- Azerbaijani\n- Basque\n- Belarusian\n- Bulgarian\n- Bosnian\n- Catalan\n- Cebuano\n- Chichewa\n- Chinese (Traditional)\n- Corsican\n- Croatian\n- Czech\n- Danish\n- Dutch\n- Esperanto\n- Estonian\n- Filipino\n- Finnish\n- Frisian\n- Galician\n- Georgian\n- Greek\n- Gujarati\n- Hausa\n- Hawaiian\n- Hebrew\n- Hmong\n- Hungarian\n- Icelandic\n- Igbo\n- Indonesian\n- Irish\n- Javanese\n- Kannada\n- Kazakh\n- Khmer\n- Korean\n- Kurdish\n- Kyrgyz\n- Lao\n- Latin\n- Latvian\n- Lithuanian\n- Luxembourgish\n- Macedonian\n- Malagasy\n- Malay\n- Malayalam\n- Maltese\n- Maori\n- Marathi\n- Mongolian\n- Myanmar (Burmese)\n- Nepali\n- Norwegian\n- Pashto\n- Persian\n- Polish\n- Punjabi\n- Romanian\n- Samoan\n- Scottish Gaelic\n- Serbian\n- Sesotho\n- Shona\n- Sindhi\n- Sinhala\n- Slovak\n- Slovenian\n- Somali\n- Sundanese\n- Swedish\n- Swahili\n- Tajik\n- Tamil\n- Telugu\n- Thai\n- Turkish\n- Ukrainian\n- Urdu\n- Uzbek\n- Vietnamese\n- Welsh\n- Xhosa\n- Yiddish\n- Yoruba\n- Zulu\n\n\u003c/details\u003e\n\n\u003c/details\u003e\n\n## 🖼️ Preview App Pages\n\n\u003cdetails\u003e\n\u003csummary\u003eDropdown all pages\u003c/summary\u003e\n\u003cdiv style=\"display: flex; flex-wrap: wrap; justify-content: center;\"\u003e\n  \u003cdiv style=\"margin: 1%; width: 24%;\"\u003e\n    \u003ch3 style=\"text-align: center;\"\u003eHome Page\u003c/h3\u003e\n    \u003cimg src=\"./readme/home.png\" width=\"100%\"/\u003e\n  \u003c/div\u003e\n  \u003cdiv style=\"margin: 1%; width: 24%;\"\u003e\n    \u003ch3 style=\"text-align: center;\"\u003eSearch Page\u003c/h3\u003e\n    \u003cimg src=\"./readme/search.png\" width=\"100%\"/\u003e\n  \u003c/div\u003e\n  \u003cdiv style=\"margin: 1%; width: 24%;\"\u003e\n    \u003ch3 style=\"text-align: center;\"\u003eDownload Game\u003c/h3\u003e\n    \u003cimg src=\"./readme/download-game.png\" width=\"100%\"/\u003e\n  \u003c/div\u003e\n  \u003cdiv style=\"margin: 1%; width: 24%;\"\u003e\n    \u003ch3 style=\"text-align: center;\"\u003eGame Metadata\u003c/h3\u003e\n    \u003cimg src=\"./readme/game-metadata.png\" width=\"100%\"/\u003e\n  \u003c/div\u003e\n  \u003cdiv style=\"margin: 1%; width: 24%;\"\u003e\n    \u003ch3 style=\"text-align: center;\"\u003eLibrary\u003c/h3\u003e\n    \u003cimg src=\"./readme/library.png\" width=\"100%\"/\u003e\n  \u003c/div\u003e\n  \u003cdiv style=\"margin: 1%; width: 24%;\"\u003e\n    \u003ch3 style=\"text-align: center;\"\u003ePlay Game\u003c/h3\u003e\n    \u003cimg src=\"./readme/playgame.png\" width=\"100%\"/\u003e\n  \u003c/div\u003e\n  \u003cdiv style=\"margin: 1%; width: 24%;\"\u003e\n    \u003ch3 style=\"text-align: center;\"\u003eDownloads\u003c/h3\u003e\n    \u003cimg src=\"./readme/downloads.png\" width=\"100%\"/\u003e\n  \u003c/div\u003e\n  \u003cdiv style=\"margin: 1%; width: 24%;\"\u003e\n    \u003ch3 style=\"text-align: center;\"\u003eProfile\u003c/h3\u003e\n    \u003cimg src=\"./readme/profile.png\" width=\"100%\"/\u003e\n  \u003c/div\u003e\n\u003c/div\u003e\n\u003c/details\u003e\n\n## 📦 The Ascendara Installer\n\nThis installer simply downloads the full setup package from GitHub and goes through the installation.\nThe latest version of Ascendara will always be installed through the tool, but you can download specific\nversions directly from the [releases page](https://github.com/Ascendara/ascendara/releases). You can view the complete source code of the installer [here on GitHub](https://github.com/Ascendara/installer).\n\n### Windows\n\n| File                                                                             | SHA-256                                                          | VirusTotal Results                                                                                                      |\n| -------------------------------------------------------------------------------- | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| [AscendaraInstaller.exe](https://cdn.ascendara.app/files/AscendaraInstaller.exe) | bfe193fea584a97e06a42ee44a7520e6e5036df1172ea6b29e960e392652249b | [3/72 Detections](https://www.virustotal.com/gui/file/bfe193fea584a97e06a42ee44a7520e6e5036df1172ea6b29e960e392652249b) |\n\n### Linux\n\nRun the following command to install Ascendara:\n\n```bash\ncurl -fsSL https://ascendara.app/install.sh | bash\n```\n\nYou can view the install script [here](https://github.com/Ascendara/installer/blob/main/install.sh).\n\n## 🤝 Contributing\n\nContributing to Ascendara is the best way to get your desired features, bug fixes, or improvements into the official build! When your contribution is accepted, your changes will be prominently featured in the Ascendara changelogs, giving you recognition for your valuable input to the project. Learn how to contribute to Ascendara [here](https://ascendara.app/docs/getting-started/contributing).\n\n## 📂 Project Structure\n\nThe Ascendara project is organized into the following main directories:\n\n### **src/** - Core application logic and UI implementation\n\n- **components/** - Reusable React components for the UI\n  - **ui/** - shadcn/ui component library for modern UI elements\n- **context/** - React context providers for global state management (authentication, language, settings, themes, tour)\n- **hooks/** - Custom React hooks for efficient image loading and caching\n- **lib/** - Utility libraries and helper functions\n- **pages/** - Main application pages and screens (Home, Library, Downloads, Settings, etc.)\n- **public/** - Static assets and public resources\n  - **sounds/** - UI sound effects\n  - **guide/** - User guide assets\n- **services/** - Service modules for external APIs and core functionality (Firebase, game info, downloads, analytics, integrations)\n- **styles/** - CSS styling files for animations, menu bar, and scrollbars\n- **translations/** - Internationalization files for 12 base languages (English, Spanish, French, German, Italian, Chinese, Arabic, Hindi, Bengali, Portuguese, Russian, Japanese)\n\n### **binaries/** - Prebuilt Python binaries for core functionality\n\n- **AscendaraAchievementWatcher/** - Tracks and monitors game achievements\n- **AscendaraCrashReporter/** - Automated crash reporting and diagnostics\n- **AscendaraDownloader/** - Multi-threaded game download manager supporting various file hosts\n- **AscendaraGameHandler/** - Game execution, process management, and runtime monitoring\n- **AscendaraLocalRefresh/** - Local game index refresh and update tool\n- **AscendaraNotificationHelper/** - System notification helper for download events\n\n  \u003e ℹ️ **INFO:** The tools below are additional tools that do not come with the official build of Ascendara. Instead, they utilize Ascendara's tool installation feature to install these supplementary tools as needed.\n\n- **AscendaraLanguageTranslation/** - Translation tool used to translate to the additional 93 languages\n- **AscendaraTorrentHandler/** - Torrent download functionality\n\n### **electron/** - Electron main process and IPC communication\n\n- **modules/** - Modular IPC handlers and backend logic (configuration, Discord RPC, downloads, games, settings, system utilities, updates, window management, and more)\n\n### **scripts/** - Development and build automation scripts for Windows/Linux builds, translation checking, and code statistics\n\n## 🛠️ Running from Source\n\nFor detailed instructions, check out the [Developer Docs](https://ascendara.app/docs/developer/build-from-source).\n\n### Prerequisites\n\nBefore building, ensure you have all required dependencies. [View full requirements](https://ascendara.app/docs/developer/build-from-source#prerequisites).\n\n### Quick Start\n\n\u003e ⚠️ **WARNING:** Some API features like reporting and analytics services will not work on the public version of the app. Additionally, you will not be able to run games in development mode. Check the [Developer Docs](https://ascendara.app/docs/developer/build-from-source#important-limitations) for more information.\n\n1. **Clone the Repository**\n\n   ```sh\n   git clone https://github.com/ascendara/ascendara.git\n   ```\n\n2. **Install Node Dependencies**\n\n\u003e **Note:** You can use any package manager you prefer, such as npm, yarn, or pnpm.\n\nUsing npm:\n\n```sh\nnpm install\n```\n\nOr using yarn:\n\n```sh\nyarn\n```\n\n3. **Configure Firebase (Optional)**\n\n   Firebase is optional for development. If you have Firebase credentials, create a `.env` file:\n\n   ```sh\n   cp .env.example .env\n   ```\n\n   Then edit `.env` and replace the placeholder values with your actual Firebase project credentials from the [Firebase Console](https://console.firebase.google.com/).\n\n   \u003e **Note:** Firebase will automatically initialize if credentials are detected. Leave the Firebase fields empty in `.env` to run in development mode without authentication features. The `.env` file is gitignored and will not be committed to the repository.\n\n4. **Install Python Dependencies**\n\n   ```sh\n   pip install -r requirements.txt\n   ```\n\n5. **Run the Development App**\n\n   Using npm:\n\n   ```sh\n   npm run start\n   ```\n\n   Or using yarn:\n\n   ```sh\n   yarn start\n   ```\n\nTo build the source code into an executable, read the [Developer Docs](https://ascendara.app/docs/developer/build-from-source).\n\n## 🗺️ Development Roadmap\n\nAscendara's development roadmap can be found [here](https://ascendara.app/roadmap).\n\n## 📝 License \u0026 Contact\n\nLicensed under [MIT](./LICENSE) - 2026 tagoWorks\n\n### Get in Touch\n\n- Email: [santiago@tago.works](mailto:santiago@tago.works)\n- Website: [tago.works](https://tago.works)\n- Discord: [Join the community](https://ascendara.app/discord)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n    \u003csub\u003eBuilt with ❤️ by \u003ca href=\"https://tago.works\"\u003etago\u003c/a\u003e\u003c/sub\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fascendara%2Fascendara","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fascendara%2Fascendara","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fascendara%2Fascendara/lists"}