How vzepec/miyoo_downloader_spanish works
Main Components
• User Environment/Terminal: This includes the Miyoo Mini Plus (or Linux terminal) from where the user executes commands.
• Main Script (main.sh): Acts as the central controller. On startup, it displays the platform selector, handles updates, and directs the workflow.
• Downloader Scripts (located under the “downloaders” directory): Each script (e.g., download_gb_spa.sh, download_nes_spa.sh, etc.) corresponds to a different gaming platform. They manage the paginated ROM listing and downloading logic.
• ROM Storage Directory: Although not directly part of the project files, the README indicates that downloaded ROMs are placed in directories like “../Roms/[Plataforma]”.
• External Service – Internet Archive: The ROM files are downloaded from this service. The system interacts with an external Internet resource.
• Supporting Elements: Auxiliary files (cookies.txt for session management or authentication, configuration files, etc.) and the Gifs folder which provides demo images for documentation.
Relationships and Data Flow
• The user interacts with the system via a console (Terminal app on Miyoo or Linux).
• When the user executes main.sh, it checks for updates and initializes the user interface (platform selection).
• The chosen downloader script then:
• Fetches the list of available ROMs (with pagination)
• Receives and processes user input for navigation, searching, or file selection.
• Initiates ROM downloads by reaching out to the Internet Archive server, potentially handling cookies or session data.
• Downloaded ROMs are then stored in the designated ROM folder structure “../Roms/[Plataforma]”.
Important Architectural Details
• Procedural Script-Oriented Design: This project uses a procedural approach with a central control (main.sh) and multiple subordinate scripts for handling different ROM download tasks.
• Separation of Concerns: Although it’s a single-script application collection, there is a clear separation between the user interface (main.sh) and the platform-specific downloading logic (in individual scripts).
• Update Mechanism: The main script includes functionality for updating itself and other scripts, emphasizing maintainability.