A local standard and VR video player for Android.
English · 简体中文
Watch on your phone or through a dual-lens VR headset, with playlists, saved playback positions, controller input and adjustable optics. AstriaVR features a blue-purple nebula theme.
| Item | Details |
|---|---|
| Requirements | Android 8.0 / API 26+, OpenGL ES 2.0 |
| Languages | Kotlin, Java |
| Playback | AndroidX Media3 / ExoPlayer |
| Application ID | dev.astriavr.player |
| Source license | No open-source license selected |
- Standard video and 180° / 360° equirectangular panoramas, with 180° fisheye, stereo fisheye, Cubemap 3×2 and EAC options depending on viewing mode.
- SBS, top/bottom and mono layouts, with automatic detection for some sources and manual overrides.
- List and grid playlists, thumbnails, sorting and saved playback positions.
- IPD, field of view, lens correction, brightness and playback speed adjustments. Comfort tuning provides an alignment grid.
- Touch, gamepad and gyroscope controls, plus an in-app controller guide.
Codec, resolution and format support depends on the device and available Android decoders. A gyroscope is optional.
- Install an APK built from this source, open the playlist and add local videos through the system file picker.
- Select a viewing mode, source projection and video layout. Override detection when necessary.
- Adjust IPD, field of view and lens correction for your phone and headset.
Playback positions are saved. Natural playback stops at the end rather than automatically advancing to another video.
Install JDK 17 or 21 and Android SDK 36 with Build Tools 36.0.0. The project uses AGP 9.0.1 and Gradle 9.1.0.
# Windows: configure JAVA_HOME and ANDROID_HOME first
.\gradlew.bat :app:assembleDebug# macOS / Linux
./gradlew :app:assembleDebugOutput: app/build/outputs/apk/debug/app-debug.apk. Debug builds use dev.astriavr.player.validation and can coexist with the distribution app. Release builds are unsigned unless you configure your own signing credentials. See the build guide for signing and verification.
app/src/main: playback, VR rendering, UI, resources and localization.app/src/androidTest: device instrumentation tests and fixtures.tests: geometry, projection, playback, controller, cache and translation checks.scripts: build, verification, source packaging and asset generation.docs/design-assets: source artwork used by the app.
Signing keys, SDKs, caches and local build outputs are excluded.
This version accesses user-selected video files through the Android system picker and declares no Internet permission. Playlists, preferences, playback positions and cover caches are stored on the device. App backup is disabled. The system picker and its file providers are managed by Android and their respective apps.
Use Issues for bug reports and suggestions. Include the app version, Android version, device model, projection and reproduction steps. Do not attach private videos or sensitive logs. See contribution guidance.
bilibili @雨星衡 · GitHub @AstriaFR
The source is public, but no open-source license has been added. Public visibility is not an additional grant of permission to use, modify or redistribute the project. Third-party dependencies retain their own license terms.