git404hub

what is aperture fr?

xdanfr/aperture — explained in plain English

Analysis updated 2026-05-18

22KotlinAudience · generalComplexity · 2/5Setup · easy

tl;dr

A Material 3 styled media player app for Android TV that plays your own local movie and TV show library.

vibe map

mindmap
  root((Aperture))
    What it does
      Plays local movies
      Plays local TV shows
      Matches artwork online
    Tech stack
      Kotlin
      Jetpack Compose for TV
      Media3 ExoPlayer
    Use cases
      Home media library
      Android TV playback
    Audience
      Android TV owners
      Home media hobbyists

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

Play a personal collection of local movies and TV shows on an Android TV device.

VIBE 2

Browse a home screen with spotlighted and recently added titles.

VIBE 3

Automatically match local video files to their correct artwork and metadata.

VIBE 4

Build the app from source in Android Studio to customize it further.

what's the stack?

KotlinJetpack ComposeMedia3ExoPlayer

how it stacks up fr

xdanfr/aperturenils0000shiyong/kuaida-ai-assistantcrowded-libs/artboard
Stars222223
LanguageKotlinKotlinKotlin
Setup difficultyeasymoderateeasy
Complexity2/52/52/5
Audiencegeneralgeneraldeveloper

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

how do i run it?

Difficulty · easy time til it works · 5min

Sideloading the APK is quick, but building from source needs Android Studio and a specific JDK version.

The README does not clearly state the license terms.

in plain english

Aperture is a media player app built for Android TV. If you have a folder of your own movies and TV shows sitting on a hard drive or storage device, Aperture scans it, matches the files to their titles and artwork using an online movie database, and presents them in a clean, modern interface that looks and feels like it belongs on a big screen TV. For it to work well, your media needs some basic organization: movies and shows should sit inside folders named Movies and TV Shows, with clear file names and a simple season and episode naming pattern for TV content. Once set up, Aperture shows a home screen with spotlighted titles and recently added media, a browsable movie library, and a TV show library that groups episodes by season. The app is written in Kotlin using Jetpack Compose for TV, Google's toolkit for building TV interfaces, and Media3 (also known as ExoPlayer) to actually play the video files. The visual style follows Google's Material 3 design language, which is the same look used across many modern Android apps. The easiest way to try it is to download the ready made app file from the project's releases page and install it directly on an Android TV device. Developers who want to build it themselves can clone the code and open it in Android Studio with JDK 17 or 21 installed. Aperture is still in an early alpha stage. The developer's roadmap lists planned additions such as better subtitle support, audio track selection, and eventually support for network storage systems like Jellyfin and Plex, plus 3D TV support. The project is open to outside contributions through pull requests and bug reports. It is licensed for anyone to use and modify.

prompts (copy fr)

prompt 1
Help me organize my movie and TV show folders so Aperture can recognize them correctly.
prompt 2
Walk me through downloading and sideloading the Aperture APK onto my Android TV.
prompt 3
Show me how to set up Android Studio with the right JDK version to build Aperture from source.
prompt 4
Explain how Media3 and Jetpack Compose for TV work together in an app like this.

Frequently asked questions

what is aperture fr?

A Material 3 styled media player app for Android TV that plays your own local movie and TV show library.

What language is aperture written in?

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

What license does aperture use?

The README does not clearly state the license terms.

How hard is aperture to set up?

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

Who is aperture for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.