Skip to content

kleidis/Troppical

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

76 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Placeholder

Troppical

What is this?

Troppical is a simple app that lets you manage your emulators with an easy installation and updating process.

We have a wide range of emulators ranging from newer consoles like the Switch to retro ones like the SNES

If you'd like an emulator to be added, feel free to open a feature request issue. Keep in mind that:

  • The emulator needs to not have a built-in way to update itself, there is no point in adding emulators that already have updaters
  • The emulator needs to be distributed on GitHub

Downloading

Get init_troppical.exe for Windows or app-release.apk for Android from Releases

Usage

To use this app, open init_troppical.exe if you're on Windows or Troppical from your app drawer if you;re on Android, select the emulator you want to install and follow the setup options.

  • For Androdi you will need to give the app install permissions in order for Troppical to work You can have multiple emulators installed at the same time

NOTES for the Windows version:

  • Windows Defender might detect this application as a trojan/malware. This is not true at all, you can look at the source code and determine that it is not a valid claim, the app isn't that complex. Please don't open an issue for this since there is nothing I can do apart from signing the app which I won't do

  • init_troppical.exe is a portable executable so feel free to run it from any directory or drive

  • Although Troppical is portable that doesn't mean the emulators are. For now, there is no way to move an emulator directory once it is installed. If you do so, Troppical will just install updates on the directory that you initially chose to install the respective emulator on. The Uninstall button will error out and prompt you to reinstall as well

Screenshot

Screenshot 2024-06-07 120452

Building for Windows

Dependencies

  • Python 3.12 (preferably not installed from the Microsoft Store)
  • pyqt6
  • pywin32
  • requests
  • pyinstaller (for compiling the app)

Install dependencies:

pip install pyqt6 pyinstaller pywin32 requests

Clone the repo:

git clone https://github.com/kleidis/Troppical.git && cd Troppical

Generate image data using base64:

python image-base64data-generator.py

Compile:

  • For main.py

pyinstaller --clean --onefile --icon=icon.ico --windowed main.py

  • For init_troppical.py (This is just a script that downloads the latest compiled main.py exe from Github Actions and runs it)

pyinstaller --clean --onefile --icon=icon.ico --windowed init_troppical.py.py