{"id":19932800,"url":"https://github.com/Ascendara/ascendara","last_synced_at":"2025-05-03T11:32:58.080Z","repository":{"id":242999855,"uuid":"805154255","full_name":"tagoWorks/ascendara","owner":"tagoWorks","description":"Effortlessly install games directly onto your PC without the hassle of extractions or file locations. Enjoy a sleek, intuitive React UI to seamlessly manage your installed games.","archived":false,"fork":false,"pushed_at":"2024-10-29T22:50:15.000Z","size":39978,"stargazers_count":4,"open_issues_count":2,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-30T00:47:36.987Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://ascendara.app","language":"JavaScript","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/tagoWorks.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},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"tagoworks","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":"2024-10-29T22:50:19.000Z","dependencies_parsed_at":"2024-07-07T10:23:34.663Z","dependency_job_id":"42f31a30-0cb3-4320-a69e-7596b116c5fc","html_url":"https://github.com/tagoWorks/ascendara","commit_stats":null,"previous_names":["tagoworks/ascendara"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tagoWorks%2Fascendara","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tagoWorks%2Fascendara/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tagoWorks%2Fascendara/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tagoWorks%2Fascendara/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tagoWorks","download_url":"https://codeload.github.com/tagoWorks/ascendara/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224360219,"owners_count":17298319,"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-11-12T23:11:35.281Z","updated_at":"2025-05-03T11:32:58.072Z","avatar_url":"https://github.com/tagoWorks.png","language":"JavaScript","funding_links":["https://ko-fi.com/tagoworks"],"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 pirating experience by providing a seamless way to download, manage, and play the pre-installed games. No more hassle with extracting, installing, or moving files. The game library is powered by a custom webscraper, currently featuring games from [STEAMRIP](https://ascendara.app/sources/steamrip) and [FitGirl](https://ascendara.app/sources/fitgirl), with plans to expand to more sources.\n\n### 👥 Community\n\n- [Join the Discord](https://discord.gg/ascendara) for discussions and support\n- [Submit feedback for Ascendara](https://ascendara.app/feedback)\n- [Read the latest changelog](https://ascendara.app/changelog)\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- 🎵 **Crisp Soundtracks**\n\n  Listen to and download high quality tracks from the games soundtrack tab.\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- 🕑 **Ascendara Timemachine**\n\n  Access and download previous versions of games with the Ascendara Timemachine.\n\n- 👤 **Your own username**\n\n  Personalize your username for online game cracks that support it.\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## Current 3rd Party Integrations\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./readme/connections.png\" width=\"60%\" alt=\"Integrations Overview\"/\u003e\n\u003c/p\u003e\n\n\u003c!-- Integration Descriptions --\u003e\n\u003ctable align=\"center\"\u003e\n  \u003ctr\u003e\n    \u003cth\u003eIntegration\u003c/th\u003e\n    \u003cth\u003eDescription\u003c/th\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cstrong\u003eGiantBomb\u003c/strong\u003e\u003c/td\u003e\n    \u003ctd\u003eCommunity-driven game metadata provider, used as a fallback when official data is unavailable.\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cstrong\u003eIGDB\u003c/strong\u003e\u003c/td\u003e\n    \u003ctd\u003eThe primary and more official source for game information, covers, and metadata.\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cstrong\u003eLudusavi\u003c/strong\u003e\u003c/td\u003e\n    \u003ctd\u003eBackup and restore for game save data.\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cstrong\u003eSteamCMD\u003c/strong\u003e\u003c/td\u003e\n    \u003ctd\u003eUsed by Ascendara's Workshop Downloader page to download workshop items.\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cstrong\u003eKHInsider\u003c/strong\u003e\u003c/td\u003e\n    \u003ctd\u003eGame soundtrack library for listening and downloading tracks from.\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## 🖼️ Preview\n\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\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). It is [open source](https://github.com/Ascendara/installer),\nand its file size is smaller than the app's NSIS installer for convenience—making it quicker to download\nand easier to distribute.\n\n| File                                                                     | SHA-256                                                          | VirusTotal Results                                                                                                      |\n| ------------------------------------------------------------------------ | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| [AscendaraInstaller.exe](https://cdn.ascendara.app/files/AscendaraInstaller.exe) | 6a7c5bc0dcac7b793156d012741c1d2be1b0a595d820d7182ac4eae4de06ef0f | [4/72 Detections](https://www.virustotal.com/gui/file/6a7c5bc0dcac7b793156d012741c1d2be1b0a595d820d7182ac4eae4de06ef0f) |\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/**: Core UI components\n  - **context/**: React context providers for state management\n  - **hooks/**: Custom hooks for efficient image loading and caching\n  - **public/**: Static assets and public resources\n  - **lib/**: Miscellaneous utility libraries and helper functions\n  - **pages/**: Main application pages/screens\n  - **services/**: Service modules for external API requests and core application functionality\n  - **styles/**: CSS and styling files\n  - **translations/**: Internationalization files\n\n- **binaries/**: Prebuilt binaries for core application functionality\n\n  - **AscendaraCrashReporter/**: Crash reporting functionality\n  - **AscendaraDownloader/**: Game download managers to handle most files\n  - **AscendaraGameHandler/**: Game execution and management\n  - **AscendaraNotificationHelper/**: Download notification helper tool\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- **scripts/**: Helper scripts for development, deployment, and maintenance\n- **electron/**: The source code for the Electron app and IPC handles\n- **installer/**: Source code for the graphical installer and setup process\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. **Install Python Dependencies**\n\n   ```sh\n   pip install -r requirements.txt\n   ```\n\n4. **Run the Development App**\n\n   \u003e ⚠️ **Note:** Before running, set `isDev = true` in `electron/app.js`.\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\n### Current Goals\n\n- [ ] Add semi-support for Linux, and macOS with Wine and Winetricks\n- [ ] Revamp game info scraping logic/API (Dynamic game indexing)\n- [ ] Improved download management (pausing, resuming)\n\n### Future Goals\n\n\u003e Want to suggest a feature you don't see here? [Contribute](https://ascendara.app/docs/getting-started/contributing) to Ascendara or [submit feedback](https://ascendara.app/feedback)!\n\n- [ ] Ascendara approved additional sources\n- [ ] Debrid support for downloads\n- [ ] Community driven path finding tool\n- [ ] Cloud data support\n- [ ] Endpoint for known games that have weird installation paths, issues, etc.\n- [ ] Break up code into files for better Organizations\n- [ ] Retry Download \u0026 Extract functionality\n\n### Completed Features\n\n- [x] Complete UI overhaul (V7)\n- [x] Legacy game version support (Ascendara Timemachine)\n- [x] Enhanced antivirus operation checks (File Verification)\n- [x] Game updating logic to be able to save time played and other metrics while updating the game\n- [x] Game ratings and reliability system\n- [x] Import games from Steam into library\n- [x] Steam workshop downloading page\n- [x] FitGirl and torrenting support\n- [x] Notification handling for desktop\n- [x] Automatic shortcut creation\n- [x] Enhanced search algorithms\n- [x] Theme customization\n- [x] Game dependencies reinstallation option\n- [x] Advanced filtering options\n- [x] Comprehensive tooltips\n- [x] Page population\n- [x] Welcome screens\n- [x] Improved tab navigation\n- [x] Separate library, downloads, and browse sections\n- [x] Custom game addition support\n- [x] Public API creation\n- [x] Popularity-based sorting\n\n## 📝 License \u0026 Contact\n\nLicensed under [CC BY-NC 1.0 Universal](./LICENSE) - 2025 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 our 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"}