Prometheus Player
User Guide
Learn to install, set up, navigate and troubleshoot Prometheus Standard and Theater Edition.
Current Versions & What’s New
Standard: 1.0.24 (Personal / Gumroad) · Theater: 1.0.23 (Personal / Gumroad). Automated checks passed; physical device playback and synchronization testing remain pending.
Important: Version numbers refer to the latest builds reported in the development conversation, not a confirmed publicly released download. The separate Prometheus VOD project is not part of this manual.
What's new in Standard 1.0.24
- Background category downloads: Category downloads can continue while navigating the app. Reopen the progress display to check progress. Avoid force-closing the application while downloading.
- Category management: Under Settings → Services, open a service and look for Manage Categories. Select categories and choose the available Download or Delete action. Deleting downloaded categories is different from deleting the entire service. Check the confirmation prompt before deleting.
- Manual refresh choices: Use the service/category refresh controls to select the content to update rather than assuming every category must be fetched again.
- Continue Watching: Local playback progress and Trakt-linked viewing activity are supported in the newer design. Find the corresponding Continue Watching entries under My Lists for Movies and Series when available; Trakt requires account authorization and a working connection.
- Compact Settings interface: Settings opens at the top with its heading visible. Services, forms and action menus use more compact spacing for remote navigation.
What's new in Theater Edition 1.0.23
- Saved-data and guide recovery: Improvements aim to recover saved configuration and guide information more reliably after interruptions.
- Category selection and per-service refresh: Manage which service categories to fetch and refresh individual services where the controls are available.
- Trakt connection retries: Retry behavior is improved; a working network and successful Trakt authorization are still required.
- Cast headshots: Image-loading improvements have been made. Headshots depend on available metadata and may still be absent for some titles.
- Virtual cinema appearance: Darker burgundy seating, black trim and richer wall/ceiling textures; cinema settings are intended to appear on a separate panel beside the screen.
Features requiring verification before public claims
Record Until End of Program, Cancel Recording and Custom Recording in the guide's long-press menu, independently added EPG-source downloading, network/series recording, backup/restore, and device-specific guide performance should be verified in the exact shipping APK. Existing recording duration and start/end padding settings are not new features. Menu names use US English, including program rather than programme.
Welcome to Prometheus
Prometheus Player is a media player for Android-based devices. It does not supply television channels, movies, subscriptions, or access credentials. You must use media and services you are authorized to access. This guide covers Standard and Theater Edition. Menu names and availability can vary by installed version. Important: Some advanced capabilities discussed below are planned or under validation; they are clearly identified rather than presented as guaranteed shipping features.
Before you begin
You need: a compatible Android TV/Google TV device or supported Android touchscreen device; the appropriate Prometheus APK; a reliable internet connection for online streams; and valid service information or your own media. Theater Edition additionally requires a compatible Meta Quest headset. Keep the installation file from your official purchase source. Prometheus is a player, not a content provider.
Install the application
Security: Do not download modified APKs from third-party sites. Exact Android settings labels differ across devices.
First launch and navigation
On a television, use the directional pad to move focus, OK/Select to activate a highlighted control, and Back to return. Some items offer additional actions through a long press of OK. On a touchscreen, tap to select and swipe within scrollable lists. Open the left-side navigation menu to switch between Live TV, TV Guide, Movies, Series, and Settings when those areas are enabled. The collapsed menu stays on the left. Do not assume every remote has identical key mapping.
Add a television service
Connection labels and fields depend on service type. Check the spelling, protocol (http/https), port, and credentials if a connection fails. Do not share your login information in support screenshots.
Manage multiple services
Open the services/playlists section of Settings to inspect each configured service. Manage a service’s categories and visibility within that service rather than in one combined hide/show list. Where supported, toggle Include On-Demand to decide whether that service contributes Movies and Series. If you remove a service, its provider-supplied channels and associated metadata may no longer appear; create a backup before major changes.
Live TV and the channel list
Select a channel and press OK to start playback. Depending on your configured view, the current program may play in a preview window above the guide; selecting full screen opens the main player. Browse categories/groups and use Favorites for channels you watch frequently. The TV Guide is designed to show more channel rows and keep the preview above the listings. Some visual arrangements differ by version and screen size.
Favorites and startup screen
Use a channel’s action menu to add or remove it from Favorites. If the Startup screen preference is available, choose Favorites to open the app directly to your saved channels. Favorites are organizational shortcuts, not separate provider subscriptions. A channel removed by the provider cannot be restored merely by keeping it in Favorites.
Rename, reorder, hide, and organize channels
Open the channel or group action menu, typically with a long press on TV remote controls. Depending on your build, options may include Rename, Reorder, Hide, Copy/Move to group, and removing a channel-name prefix or number. Use the destination picker when copying or moving channels. Hidden channels and hidden groups should be managed per service. If a particular action is missing, it may not yet be enabled in your installed build. Reordering and custom naming should be checked after restarting the app to confirm persistence.
TV Guide (EPG)
The Electronic Program Guide shows scheduled programming for channels that have matching guide data. Open TV Guide from the left menu. Move vertically to choose a channel and horizontally through available listings. The guide is intended not to scroll backward before the current time slot. Program information depends on the EPG provider; missing titles or descriptions are not necessarily a player fault. Guide refreshes can take time on large playlists.
Add and manage EPG sources
Open the TV Guide/EPG settings area to add or edit an authorized EPG URL. Multiple guide sources may be configured. To assign a source to a specific channel, open that channel’s long-press action menu, select the EPG assignment action when available, search for the matching guide channel, and save. Refresh the guide and confirm the program schedule matches the channel and time zone. A source may load successfully yet contain no matching entries.
Refresh and troubleshoot guide data
Start with a manual EPG refresh. Confirm the EPG URL is accessible, the device clock/time zone is correct, and the channel is mapped to the right guide identifier. If only some programs load, retry after the source responds or try a smaller service/group. Under development or validation: background retry logic, guide downloads restricted to visible channels/groups, and per-channel or per-group refresh from a long press. Do not rely on these controls until you see them in your build.
Movies and series
When a service includes on-demand content, open Movies or Series from the left navigation menu. Browse categories and select a title to inspect its available details and play it. Series may be arranged by season and episode. Artwork, episode descriptions, and availability depend on the provider and metadata. Under development or validation: smaller posters, continuous scrolling, hiding categories, episode thumbnails, last-watched markers, automatic next episode, and integrated viewing history.
Resume and viewing history
Where enabled, Continue Watching resumes supported on-demand playback from the last saved position. In newer builds, check My Lists for local and Trakt-linked Continue Watching entries under Movies and Series. A separate History view may also appear inside Movies or Series. If a title starts from the beginning, confirm that your version supports resume for that content type and that app data has not been cleared. Resume and history behavior must be verified against the specific release.
Playback controls and options
During playback, press OK or tap the screen to reveal player controls where supported. Typical controls include play/pause, seek, audio-track selection, and subtitles when provided by the stream. Some builds may expose an external player option and technical playback details such as resolution, codec, or bitrate. Planned/validation features: multiview, Android picture-in-picture, manual frame-rate and deinterlacing options, audio delay, and passthrough controls. Hardware and stream compatibility can limit these features.
Add your own media as a channel
Planned/validation: an option to add a local video file or authorized direct media URL as a channel. Once present in your build, use the channel-management action to select a file or enter a URL, name the channel, choose its group, and save. This is not a method for bypassing paywalls or access restrictions. Verify local storage permissions if the file is not visible.
Recording and storage
Feature status: advanced recording is under development or validation. Intended destinations include supported internal storage, USB drives, SD cards, and networked computers/NAS shares. Before recording, verify write permission, free space, and the file system supported by your device. Network shares generally require a reachable SMB host and appropriate credentials; automatic discovery does not guarantee access. Series/recurring recording and built-in SMB/NAS setup should not be advertised as completed until tested in a release. Recording rights and provider limitations vary.
Remote and parental settings
Planned/validation: remote button and long-press remapping, configurable Back behavior, PIN locks for channels, groups and settings, and hiding protected groups until a PIN is entered. When these options are visible, use Settings to configure them and test your PIN before relying on the protection. A PIN within the app is not a substitute for device-level parental controls.
Back up and restore your setup
Planned/validation: export and restore of a Prometheus configuration backup using the project’s `.sqt` format. When available, export a backup before changing devices or resetting the app; store it somewhere safe. Restore using the matching in-app action and verify services, group changes, Favorites, and EPG assignments afterward. A cache clear should not delete saved setup, but clearing app storage/data or uninstalling may. Until backup/restore is release-verified, do not treat a backup as your only copy of credentials and settings.
Performance and maintenance
For slow menus or guide navigation, first restart Prometheus and the device. Reduce oversized categories where possible and refresh guide data after the device has settled. Check available storage and Android updates. Clearing the cache is different from clearing app data; do not clear app data unless you are prepared to reconfigure the app. Stream buffering may come from network speed, provider congestion, or codec support rather than the interface.
Prometheus Theater Edition — overview
Theater Edition is a separate build intended for Meta Quest. It adds an immersive virtual cinema environment while retaining applicable player functions. The theater is not a separate streaming subscription. Use your headset’s supported input methods to navigate the app and the theater controls. Exact control bindings depend on the release and Quest environment.
Theater seating, screen, and lighting
Open the theater controls during viewing to select a seating position and adjust the virtual viewing experience. The newer Theater builds introduce dark burgundy seating with black sides/trim, darker textured walls and ceiling, and warm brown/black accents. The cinema-settings panel is intended to appear as a pop-out beside the screen rather than obstructing the movie. These are release-specific visual targets; confirm your installed Theater build includes them.
Theater troubleshooting
If the theater screen orientation looks wrong, exit and re-enter the theater view, then restart the app if necessary. If the screen feels too far away, use the available seat/view controls. If entering service details is difficult in VR, check whether clipboard paste is supported in the current release; keyboard and clipboard behavior can vary. A VR-only control mode may be offered as an optional toggle in future versions.
Common problems and fixes
App will not install: verify APK/device compatibility, storage, and Android installation permission.
Service will not connect: check server URL, credentials, network access, and whether the provider is online.
Channels load but EPG is blank: verify the guide source and channel mapping, then refresh.
Playback buffers: test a different authorized stream and connection; compare Wi-Fi and wired networking if available.
Remote feels delayed: restart the device and reduce guide load; do not assume a cache clear will fix every device-specific issue.
Movies or Series missing: check the service’s on-demand inclusion setting and whether your provider supplies VOD.
Settings disappeared after reset: clearing app data can erase local configuration.
Feature described here is missing: consult the installed version and release notes; planned features are not guaranteed to be present.
Frequently asked questions
Does Prometheus include channels? No. It is a player; users provide authorized services or their own media.
Is Theater Edition the same app? No. It is a separate VR-focused edition.
Can I use more than one provider? The application is designed around managing multiple services; availability may vary by build.
Can I use a touchscreen? The intended experience includes touch navigation and scrolling on supported Android devices.
Does clearing cache delete playlists? It should not; clearing app data is different and may remove saved setup.
Can I record to my computer? Network recording is a planned/validation feature, not a confirmed universal capability.
Where do I find version information? Check the app’s Settings/About area if present, or the APK/package information in Android settings.
Glossary
APK: Android installation package. EPG: Electronic Program Guide. Xtream Codes / Stalker: Service connection methods supported by certain providers. VOD: Video on demand, including movies and series. SMB: Network file-sharing protocol. NAS: Network-attached storage. Cache: Temporary files used for performance. App data: Stored configuration and other persistent application information. PiP: Picture-in-picture. Sideload: Install an Android app from an APK rather than an app store.
Support, updates, and release notes
Before contacting support, record the app edition and version, device model, Android version, what you were doing, and the exact error message. Include screenshots only after hiding passwords, tokens, server credentials, and private URLs. Check the official product page for the current release and verified feature list. Publisher checklist before launch: replace all planned/validation notes with release-tested instructions, add annotated screenshots of each real menu, insert official download/support links, and confirm licensing/activation steps against the shipping APK.