Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/ascendara/ascendara

Skip extracting files, navigating setup processes, or any unnecessary hassles.
https://github.com/ascendara/ascendara

api fitgirl javascript python steam

Last synced: 6 days ago
JSON representation

Skip extracting files, navigating setup processes, or any unnecessary hassles.

Awesome Lists containing this project

README 

          


    Ascendara Logo

    
Ascendara


    
The best way to test games before you buy them.


    


        Discord

        Latest Release

         Download Count

        License

    


    


        Issues

        Last Commit

        Build Status

        Forks

        GitHub Stars

    





## 🎮 About



Ascendara 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.



### 🔗 Quick Links



- [Join the Discord](https://ascendara.app/discord) for discussions and support

- [Submit feedback for Ascendara](https://ascendara.app/feedback)

- [Contribute to Ascendara](https://github.com/tagoWorks/ascendara)

- [Read the latest changelog](https://ascendara.app/changelog)

- [Learn about Ascend](https://ascendara.app/ascend)

- [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.



- ☁ī¸ **Cloud Backups**



  Upload game backup files to a secure Cloudflare storage system for safekeeping.



- 🔌 **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.



- 🕑 **Local Indexing**



  Search for games at crazy speeds and always stay up to date.



- 📱 **Encrypted Remote Access**



  View download progression from anywhere, all data is end-to-end encrypted.

  

- 🌍 **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



## đŸ–ŧī¸ Preview App Pages



Dropdown all pages



  


    
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). You can view the complete source code of the installer [here on GitHub](https://github.com/Ascendara/installer).



### Windows



| File                                                                             | SHA-256                                                          | VirusTotal Results                                                                                                      |

| -------------------------------------------------------------------------------- | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |

| [AscendaraInstaller.exe](https://cdn.ascendara.app/files/AscendaraInstaller.exe) | bfe193fea584a97e06a42ee44a7520e6e5036df1172ea6b29e960e392652249b | [3/72 Detections](https://www.virustotal.com/gui/file/bfe193fea584a97e06a42ee44a7520e6e5036df1172ea6b29e960e392652249b) |



### Linux



Run the following command to install Ascendara:



```bash

curl -fsSL https://ascendara.app/install.sh | bash

```



You can view the install script [here](https://github.com/Ascendara/installer/blob/main/install.sh).



## 🤝 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/** - Reusable React components for the UI

  - **ui/** - shadcn/ui component library for modern UI elements

- **context/** - React context providers for global state management (authentication, language, settings, themes, tour)

- **hooks/** - Custom React hooks for efficient image loading and caching

- **lib/** - Utility libraries and helper functions

- **pages/** - Main application pages and screens (Home, Library, Downloads, Settings, etc.)

- **public/** - Static assets and public resources

  - **sounds/** - UI sound effects

  - **guide/** - User guide assets

- **services/** - Service modules for external APIs and core functionality (Firebase, game info, downloads, analytics, integrations)

- **styles/** - CSS styling files for animations, menu bar, and scrollbars

- **translations/** - Internationalization files for 12 base languages (English, Spanish, French, German, Italian, Chinese, Arabic, Hindi, Bengali, Portuguese, Russian, Japanese)



### **binaries/** - Prebuilt Python binaries for core functionality



- **AscendaraAchievementWatcher/** - Tracks and monitors game achievements

- **AscendaraCrashReporter/** - Automated crash reporting and diagnostics

- **AscendaraDownloader/** - Multi-threaded game download manager supporting various file hosts

- **AscendaraGameHandler/** - Game execution, process management, and runtime monitoring

- **AscendaraLocalRefresh/** - Local game index refresh and update tool

- **AscendaraNotificationHelper/** - System notification helper for download events



  > ℹī¸ **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



### **electron/** - Electron main process and IPC communication



- **modules/** - Modular IPC handlers and backend logic (configuration, Discord RPC, downloads, games, settings, system utilities, updates, window management, and more)



### **scripts/** - Development and build automation scripts for Windows/Linux builds, translation checking, and code statistics



## 🛠ī¸ 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. **Configure Firebase (Optional)**



   Firebase is optional for development. If you have Firebase credentials, create a `.env` file:



   ```sh

   cp .env.example .env

   ```



   Then edit `.env` and replace the placeholder values with your actual Firebase project credentials from the [Firebase Console](https://console.firebase.google.com/).



   > **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.



4. **Install Python Dependencies**



   ```sh

   pip install -r requirements.txt

   ```



5. **Run the Development App**



   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



Ascendara's development roadmap can be found [here](https://ascendara.app/roadmap).



## 📝 License & Contact



Licensed under [MIT](./LICENSE) - 2026 tagoWorks



### Get in Touch



- Email: [santiago@tago.works](mailto:santiago@tago.works)

- Website: [tago.works](https://tago.works)

- Discord: [Join the community](https://ascendara.app/discord)



---





    Built with ❤ī¸ by tago