Pull Request: Add native Windows (AmpleWin) and Linux (AmpleLinux) ports#46
Open
anomixer wants to merge 31 commits intoksherlock:masterfrom
Open
Pull Request: Add native Windows (AmpleWin) and Linux (AmpleLinux) ports#46anomixer wants to merge 31 commits intoksherlock:masterfrom
anomixer wants to merge 31 commits intoksherlock:masterfrom
Conversation
…ptive UI, optimized engine, and internationalized documentation
…VGM Recording, and Shared Directory Support
…-browse Shared Directory
… ROM search filter
… SCSI sub-slot emulation
- Ported from AmpleWin with ~20 Linux-specific adaptations - Replaced winreg with gsettings/KDE dark mode detection - Replaced os.startfile with xdg-open - Removed MAME auto-download (users install via package manager) - Added system-wide MAME detection (PATH, /usr/bin, /usr/games) - Removed all .exe suffixes from binary references - Created AmpleLinux.sh launcher script - Dual-language READMEs (English + Traditional Chinese)
Updated user guidance for Windows and Linux users.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR introduces full support for Windows and Linux platforms, expanding Ample from a macOS-exclusive tool to a cross-platform frontend.
To ensure stability and avoid conflicts with the existing macOS codebase, the new ports are contained in their own dedicated directories (
AmpleWin/andAmpleLinux/) while keeping the root structure clean.� Isolation & Safety
I have NOT touched any of your original macOS code. The only file modified in the root directory is
README.md, simply to add links to the new Windows/Linux ports.You can freely modify these links to point to your own repository structure if you choose to merge this.
�🚀 Key Features
🪟 Windows Port (
AmpleWin/)AmpleWin.batscript for easy startup.🐧 Linux Port (
AmpleLinux/)AmpleLinux.shautomatically creates a virtual environment (venv) and installs dependencies (PySide6, etc.) on the first run.build_elf.shscript using PyInstaller to create a standalone binary. It also generates and installs a.desktopfile for proper application menu integration.snap install mameon Ubuntu.binutils/objcopy) required by PyInstaller.📝 Documentation
README.mdto reference the new ports.README.mdandREADME_tw.mdinside each port directory.✅ Verification
I have tested these changes on:
AmpleLinux.shsetup,build_elf.shbinary generation, and icon integration.Hope this helps expand the user base for Ample! Thanks for the great original work.