https://github.com/Ascendara/ascendara
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.
https://github.com/Ascendara/ascendara
Last synced: about 1 year ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/Ascendara/ascendara
- Owner: tagoWorks
- License: other
- Created: 2024-05-24T01:51:56.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-29T22:50:15.000Z (over 1 year ago)
- Last Synced: 2024-10-30T00:47:36.987Z (over 1 year ago)
- Language: JavaScript
- Homepage: https://ascendara.app
- Size: 38.1 MB
- Stars: 4
- Watchers: 2
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
Ascendara
The best way to test games before you buy them.
## 🎮 About
Ascendara 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.
### 👥 Community
- [Join the Discord](https://discord.gg/ascendara) for discussions and support
- [Submit feedback for Ascendara](https://ascendara.app/feedback)
- [Read the latest changelog](https://ascendara.app/changelog)
- [Check latest releases on Github](https://github.com/tagoWorks/ascendara/releases)
## ✨ Features
- 🚀 **Seamless Downloads**
Lightning-fast 2 click download for games that support it. No browser needed at all.
- 🎵 **Crisp Soundtracks**
Listen to and download high quality tracks from the games soundtrack tab.
- 🔌 **Game Information**
View game info, including the game's story, soundtrack, and more with Ascendara Xtra.
- 🌐 **Browser Integration**
Seamlessly integrate with your browser for one-click game downloads and management.
- 🎨 **Theme Customization**
Beautiful, appealing themes to choose from for a truly unique experience.
- 🕑 **Ascendara Timemachine**
Access and download previous versions of games with the Ascendara Timemachine.
- 👤 **Your own username**
Personalize your username for online game cracks that support it.
- 🌍 **105 Languages Support**
Full interface support for 105 different languages, making Ascendara accessible worldwide.
See the 12 base languages
These languages come with the app by default:
- English
- Spanish
- French
- German
- Italian
- Chinese
- Arabic
- Hindi
- Bengali
- Portuguese
- Russian
- Japanese
Want to see the full list?
- Afrikaans
- Albanian
- Amharic
- Armenian
- Azerbaijani
- Basque
- Belarusian
- Bulgarian
- Bosnian
- Catalan
- Cebuano
- Chichewa
- Chinese (Traditional)
- Corsican
- Croatian
- Czech
- Danish
- Dutch
- Esperanto
- Estonian
- Filipino
- Finnish
- Frisian
- Galician
- Georgian
- Greek
- Gujarati
- Hausa
- Hawaiian
- Hebrew
- Hmong
- Hungarian
- Icelandic
- Igbo
- Indonesian
- Irish
- Javanese
- Kannada
- Kazakh
- Khmer
- Korean
- Kurdish
- Kyrgyz
- Lao
- Latin
- Latvian
- Lithuanian
- Luxembourgish
- Macedonian
- Malagasy
- Malay
- Malayalam
- Maltese
- Maori
- Marathi
- Mongolian
- Myanmar (Burmese)
- Nepali
- Norwegian
- Pashto
- Persian
- Polish
- Punjabi
- Romanian
- Samoan
- Scottish Gaelic
- Serbian
- Sesotho
- Shona
- Sindhi
- Sinhala
- Slovak
- Slovenian
- Somali
- Sundanese
- Swedish
- Swahili
- Tajik
- Tamil
- Telugu
- Thai
- Turkish
- Ukrainian
- Urdu
- Uzbek
- Vietnamese
- Welsh
- Xhosa
- Yiddish
- Yoruba
- Zulu
## Current 3rd Party Integrations
Integration
Description
GiantBomb
Community-driven game metadata provider, used as a fallback when official data is unavailable.
IGDB
The primary and more official source for game information, covers, and metadata.
Ludusavi
Backup and restore for game save data.
SteamCMD
Used by Ascendara's Workshop Downloader page to download workshop items.
KHInsider
Game soundtrack library for listening and downloading tracks from.
## 🖼️ Preview
Home Page
Search Page
Download Game
Game Metadata
Library
Play Game
Downloads
Profile
## 📦 The Ascendara Installer
This installer simply downloads the full setup package from GitHub and goes through the installation.
The latest version of Ascendara will always be installed through the tool, but you can download specific
versions directly from the [releases page](https://github.com/Ascendara/ascendara/releases). It is [open source](https://github.com/Ascendara/installer),
and its file size is smaller than the app's NSIS installer for convenience—making it quicker to download
and easier to distribute.
| File | SHA-256 | VirusTotal Results |
| ------------------------------------------------------------------------ | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| [AscendaraInstaller.exe](https://cdn.ascendara.app/files/AscendaraInstaller.exe) | 6a7c5bc0dcac7b793156d012741c1d2be1b0a595d820d7182ac4eae4de06ef0f | [4/72 Detections](https://www.virustotal.com/gui/file/6a7c5bc0dcac7b793156d012741c1d2be1b0a595d820d7182ac4eae4de06ef0f) |
## 🤝 Contributing
Contributing 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).
## 📂 Project Structure
The Ascendara project is organized into the following main directories:
- **src/**: Core application logic and UI implementation
- **components/**: Core UI components
- **context/**: React context providers for state management
- **hooks/**: Custom hooks for efficient image loading and caching
- **public/**: Static assets and public resources
- **lib/**: Miscellaneous utility libraries and helper functions
- **pages/**: Main application pages/screens
- **services/**: Service modules for external API requests and core application functionality
- **styles/**: CSS and styling files
- **translations/**: Internationalization files
- **binaries/**: Prebuilt binaries for core application functionality
- **AscendaraCrashReporter/**: Crash reporting functionality
- **AscendaraDownloader/**: Game download managers to handle most files
- **AscendaraGameHandler/**: Game execution and management
- **AscendaraNotificationHelper/**: Download notification helper tool
> ℹ️ 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.
- **AscendaraLanguageTranslation/**: Translation tool used to translate to the additional 93 languages
- **AscendaraTorrentHandler/**: Torrent download functionality
- **scripts/**: Helper scripts for development, deployment, and maintenance
- **electron/**: The source code for the Electron app and IPC handles
- **installer/**: Source code for the graphical installer and setup process
## 🛠️ Running from Source
For detailed instructions, check out the [Developer Docs](https://ascendara.app/docs/developer/build-from-source).
### Prerequisites
Before building, ensure you have all required dependencies. [View full requirements](https://ascendara.app/docs/developer/build-from-source#prerequisites).
### Quick Start
> ⚠️ **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.
1. **Clone the Repository**
```sh
git clone https://github.com/ascendara/ascendara.git
```
2. **Install Node Dependencies**
> **Note:** You can use any package manager you prefer, such as npm, yarn, or pnpm.
Using npm:
```sh
npm install
```
Or using yarn:
```sh
yarn
```
3. **Install Python Dependencies**
```sh
pip install -r requirements.txt
```
4. **Run the Development App**
> ⚠️ **Note:** Before running, set `isDev = true` in `electron/app.js`.
Using npm:
```sh
npm run start
```
Or using yarn:
```sh
yarn start
```
To build the source code into an executable, read the [Developer Docs](https://ascendara.app/docs/developer/build-from-source).
## 🗺️ Development Roadmap
### Current Goals
- [ ] Add semi-support for Linux, and macOS with Wine and Winetricks
- [ ] Revamp game info scraping logic/API (Dynamic game indexing)
- [ ] Improved download management (pausing, resuming)
### Future Goals
> 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)!
- [ ] Ascendara approved additional sources
- [ ] Debrid support for downloads
- [ ] Community driven path finding tool
- [ ] Cloud data support
- [ ] Endpoint for known games that have weird installation paths, issues, etc.
- [ ] Break up code into files for better Organizations
- [ ] Retry Download & Extract functionality
### Completed Features
- [x] Complete UI overhaul (V7)
- [x] Legacy game version support (Ascendara Timemachine)
- [x] Enhanced antivirus operation checks (File Verification)
- [x] Game updating logic to be able to save time played and other metrics while updating the game
- [x] Game ratings and reliability system
- [x] Import games from Steam into library
- [x] Steam workshop downloading page
- [x] FitGirl and torrenting support
- [x] Notification handling for desktop
- [x] Automatic shortcut creation
- [x] Enhanced search algorithms
- [x] Theme customization
- [x] Game dependencies reinstallation option
- [x] Advanced filtering options
- [x] Comprehensive tooltips
- [x] Page population
- [x] Welcome screens
- [x] Improved tab navigation
- [x] Separate library, downloads, and browse sections
- [x] Custom game addition support
- [x] Public API creation
- [x] Popularity-based sorting
## 📝 License & Contact
Licensed under [CC BY-NC 1.0 Universal](./LICENSE) - 2025 tagoWorks
### Get in Touch
- Email: [santiago@tago.works](mailto:santiago@tago.works)
- Website: [tago.works](https://tago.works)
- Discord: [Join our community](https://ascendara.app/discord)
---