How videolan/vlc-android works
VLC for Android is a media player and library browser, with phone and TV interfaces. The main user journey is selecting local or network media, browsing or searching the library, and starting playback through the playback service and VLC engine. Other major capabilities include subtitle lookup, casting, metadata scraping, and remote access. The tree and excerpts show key modules, but not every runtime call; README-backed edges document product capabilities, while uncertain wiring is omitted or marked unverified.
Main entry points: PlaybackService.kt Playback service · browser Media browser · Medialibrary.java Media library · PlaylistManager.kt Playlist manager
Components 22
Media discovery
- Media browser
application/vlc-android/src/org/videolan/vlc/gui/browser - Storage provider
application/vlc-android/src/org/videolan/vlc/providers/StorageProvider.kt - Media library
medialibrary/src/org/videolan/medialibrary/interfaces/Medialibrary.java - Media items
medialibrary/src/org/videolan/medialibrary/interfaces/media/MediaWrapper.java - TV search
application/television/src/main/java/org/videolan/television/ui/SearchFragment.kt
Playback
- Playlist manager
application/vlc-android/src/org/videolan/vlc/media/PlaylistManager.kt - Playback service
application/vlc-android/src/org/videolan/vlc/PlaybackService.kt - Video player
application/vlc-android/src/org/videolan/vlc/gui/video/VideoPlayerActivity.kt - LibVLC engine
- Engine options
application/resources/src/main/java/org/videolan/resources/VLCOptions.kt
Media services
- Subtitle lookup
application/resources/src/main/java/org/videolan/resources/opensubtitles/OpenSubtitleService.kt - Metadata scraping
application/moviepedia/src/main/java/org/videolan/moviepedia/MediaScraper.kt - Metadata store
application/moviepedia/src/main/java/org/videolan/moviepedia/database/MoviePediaDatabase.kt
User interfaces
Remote access
- Remote setup UI
application/remote-access-server/src/main/java/org/videolan/vlc/remoteaccessserver/gui/remoteaccess/RemoteAccessShareActivity.kt - Remote service
application/remote-access-server/src/main/java/org/videolan/vlc/remoteaccessserver/RemoteAccessService.kt - Remote server
application/remote-access-server/src/main/java/org/videolan/vlc/remoteaccessserver/RemoteAccessServer.kt
Other components
- VLC user
- Remote client
- Cast renderer
- Network media
Connections 23
- VLC user → Phone UI: browses
- VLC user → TV UI: browses
- Phone UI → Media browser: opens browser
application/vlc-android/src/org/videolan/vlc/gui/browser/MLStorageBrowserFragment.kt - Media browser → Storage provider: lists storage
application/vlc-android/src/org/videolan/vlc/providers/StorageProvider.kt - Media browser → Media library: browses library
application/vlc-android/src/org/videolan/vlc/gui/browser/StorageBrowserFragment.kt - TV search → Media library: searches
application/television/src/main/java/org/videolan/television/ui/SearchFragment.kt - Media library → Media items: provides media
medialibrary/src/org/videolan/medialibrary/interfaces/Medialibrary.java - VLC user → Network media: selects media
- Media browser → Playlist manager: queues media
application/vlc-android/src/org/videolan/vlc/media/PlaylistManager.kt - Playlist manager → Playback service: controls playback
application/vlc-android/src/org/videolan/vlc/PlaybackService.kt - Playback service → LibVLC engine: plays media
- Playback service → Media library: reads media
application/vlc-android/src/org/videolan/vlc/PlaybackService.kt - Engine options → LibVLC engine: configures
- Playback service → Video player: opens video
application/vlc-android/src/org/videolan/vlc/PlaybackService.kt - Playback service → Subtitle lookup: looks up subtitles
- VLC user → Metadata scraping: requests metadata
- Metadata scraping → Metadata store: stores metadata
- VLC user → Remote setup UI: enables access
- Remote setup UI → Remote service: configures service
- Remote service → Remote server: starts server
application/remote-access-server/src/main/java/org/videolan/vlc/remoteaccessserver/RemoteAccessService.kt - Remote client → Remote server: connects remotely
- Playback service → Cast renderer: casts media
- Network media → Media browser: provides streams