git404hub

what is retrostash fr?

sleepyturtle91/retrostash — explained in plain English

Analysis updated 2026-05-18

1KotlinAudience · generalComplexity · 3/5LicenseSetup · easy

tl;dr

An Android app that browses and downloads retro game files from Archive.org with AI-powered filtering.

vibe map

mindmap
  root((repo))
    What it does
      Browses Archive.org
      AI filtering
      Downloads files
    Tech stack
      Kotlin
      Jetpack Compose
      Gemini API
    Features
      Multi-category search
      Smart download queue
      Metadata and box art
    Use cases
      Download retro roms
      Filter large collections
    Audience
      Retro gamers
      Archivists

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Browse and download retro game roms from Archive.org directly on a handheld console.

VIBE 2

Use natural language prompts to filter a large Archive.org collection down to what you want.

VIBE 3

Automatically fetch box art and metadata for a local retro game library.

VIBE 4

Download books, movies, or audio collections from Archive.org on Android.

what's the stack?

KotlinJetpack ComposeRetrofitKtorGemini API

how it stacks up fr

sleepyturtle91/retrostashmfori/bit-aesnacode-studios/kdrant
Stars111
LanguageKotlinKotlinKotlin
Last pushed2020-05-11
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity3/52/53/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Requires a free Gemini API key from Google AI Studio and an Android 8.0+ device.

MIT licensed, free to use, modify, and distribute for any purpose including commercial use.

in plain english

RetroStash is an Android app built for retro gaming fans and archivists who want to pull files from Archive.org onto their device. It lets you browse Archive.org collections, use AI to filter and sort large result lists with plain language prompts, and download files directly with handling built for handheld gaming consoles. Search covers more than just game roms: it also supports PC games, books, movies, audio, and images, each with its own tailored search query builder. The AI filtering, powered by Google's Gemini model, lets you type something like only RPGs or USA region only and have the list narrowed and sorted automatically instead of scrolling through everything by hand. The interface is built to work well on both portrait phones and landscape handheld consoles such as the Anbernic RG556 and RG557, switching to a two column grid layout in landscape to make better use of the screen. On the download side, the app actively monitors its queue, automatically extracts ZIP archives, and safely moves files that are not ZIPs or that fail extraction instead of deleting them, so nothing gets silently lost. If one download fails, the queue unblocks itself and moves on to the next item rather than getting stuck. There is also a metadata and box art system that scans your downloaded collection, uses AI to identify which console a game belongs to and clean up its title, and generates a gameList.xml file plus named box art images following Libretro's conventions, along with a Clear Finished option to tidy up completed and failed downloads. To use it you need an Android device running Android 8.0 or newer and a free Gemini API key from Google AI Studio, which you enter in the app's settings along with the destination folder where you want files saved. It is built with Kotlin and Jetpack Compose for the interface, Retrofit, OkHttp, and Ktor for networking, and WorkManager alongside Android's DownloadManager for background downloads and unzipping. The project is released under the MIT license.

prompts (copy fr)

prompt 1
Help me set up RetroStash with a Gemini API key and destination folder on Android.
prompt 2
Show me how to use RetroStash's AI filtering to find only USA-region RPG roms.
prompt 3
Explain how RetroStash's download queue handles failed or non-ZIP files.
prompt 4
Walk me through how RetroStash generates gameList.xml and box art for Libretro.

Frequently asked questions

what is retrostash fr?

An Android app that browses and downloads retro game files from Archive.org with AI-powered filtering.

What language is retrostash written in?

Mainly Kotlin. The stack also includes Kotlin, Jetpack Compose, Retrofit.

What license does retrostash use?

MIT licensed, free to use, modify, and distribute for any purpose including commercial use.

How hard is retrostash to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is retrostash for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.