Help & Documentation

Answers for every screen.
Your personal media player & library.

Play your videos with native hardware acceleration, open local files, connect personal media storage, and organize your watchlists into a stunning poster-art gallery across iPhone and 4789 TV.

Topic intent detected: Casting
Showing all 39 questions
10-Second Truth

Media Player & Library Organizer

4789 plays your video files and connected media storage with hardware acceleration, opens local files from the iOS Files app or USB-C drives, and organizes your watchlists into a beautiful poster gallery with zero accounts.

  • Plays local & connected media: Hardware-accelerated MKV, MP4, local files, and personal cloud storage.
  • Organizes your watchlists: Curate custom lists (e.g. Korean cinema, genre feeds, Letterboxd).
  • Poster-art canvas & TV cast: Edge-to-edge Wall gallery, instant TV link handoff, and remote.
TV Receiver Setup

TV Downloader Code: 5873252

Get 4789 TV onto your Fire TV Stick, Google TV, or Android TV in under 60 seconds using the free Downloader app from your TV app store.

  • Downloader Quick Code: Enter 5873252 and click Go.
  • Direct Ports: Playback receiver on port 8791, discovery on 9791.
  • Operating Systems: Android TV 9.0+ & Fire OS 7.0+ supported.
Device Compatibility

Hardware Support Matrix

Native Swift and Kotlin architecture delivers high-efficiency hardware-accelerated playback across mobile and television hardware.

  • Supported: iPhone (iOS 16+), Android TV, Google TV, Fire TV Stick, Shield TV.
  • Not Supported: Apple TV (tvOS), Roku, or Amazon Vega OS (2025+ models).
  • Local Bridge: Seamless phone-to-TV playback handoff and docked remote controls.
Section 01

Getting Started & Philosophy

What 4789 is, how it works, and how it treats your privacy.

What is 4789 in simple English?

4789 is a personal media player and library organizer for iPhone and television. It plays your videos with native hardware acceleration, opens your local files, connects your personal media storage and playback services, and organizes your entire watch history into a stunning poster-art library.

Play Your Media. Organize Your Library.

Much like advanced media players such as Infuse or Kodi, 4789 combines a high-performance playback engine with visual library management: play your local files, connect personal media storage, curate custom cinema lists, and enjoy an ambient poster wall with zero accounts and zero ads.

Here is what 4789 does for you:

01
Play Your Videos & Connected Services: Hardware-accelerated 4K HDR playback powered by a custom MPV engine. Plays virtually all containers (MKV, MP4, MOV) with full audio bitstream passthrough and subtitle styling. Connect your compatible personal media storage or cloud playback services to stream your files smoothly.
02
Open & Import Local Files: Open personal video files directly from the iOS Files app, iCloud Drive, or connected USB-C flash drives and external SSDs on iPhone 15/16. 4789 parses the files, matches poster artwork, and tracks your playback position automatically.
03
Organize & Grow Your Watchlists: Keep your watchlist, build queues, and curate specialized shelves. Pull in public lists from Letterboxd, MDBList, and Trakt—whether that is a collection of Korean cinema classics, indie festival winners, 90s cyberpunk, or director filmographies—unified into clean, organized manifests.
04
A Living Poster-Art Gallery (Wall & Discover): Experience your media like an art collection. Wall mode transforms your phone into an edge-to-edge, ambient canvas of high-resolution poster art with zero clutter. Browse structured shelves in Discover or tap any poster for cast info, trailers, and reviews.
05
Free Public Keys & Recommendations: Connect your free public API keys (MDBList, TMDB, Trakt) to enrich your library with multi-source critic ratings (IMDb, Letterboxd, Metacritic, Rotten Tomatoes), synopsis, and personalized recommendations without subscription fees.
06
Instant TV Handoff & Docked Remote: Send any video playing on your iPhone to 4789 TV (Fire TV Stick, Google TV, Android TV, Shield) over local Wi-Fi with one tap. Your phone automatically becomes a docked glass remote to scrub, adjust volume, and switch subtitle tracks.
07
Fun-Filled Features & Film Easter Eggs: Enjoy thoughtful craft—interactive rating wheels, tactile gesture physics, "Surprise Me" shuffle rolls, and hidden Easter eggs designed for film buffs.

Everything runs 100% locally on your device. Zero accounts, zero analytics, zero data logging. Your credentials, files, and watch history never leave your hardware.

Does 4789 provide or host movies and shows?

No. 4789 does not supply, host, or sell video files. Like Infuse, VLC, or Kodi, it is an independent media player and library organizer.

You provide your media: open local video files from your device or USB drive, connect your personal cloud media storage and playback services, or attach public catalog lists. 4789 fetches artwork and metadata, organizes your watchlists, and plays your videos through an advanced hardware-accelerated engine.

What are the "Two Doors" (Discover & Wall) and how do I navigate them?

4789 is built around an architectural invariant of exactly two top-level doors, keeping navigation instant and uncluttered:

01
Discover: Your structured home. Contains your customizable shelves, Continue Watching, trending feeds, public lists, search, and direct settings access.
02
Wall: An ambient visual canvas of high-resolution poster art. Tap or drag through posters smoothly with zero chrome.

Tapping any poster from either door opens the same unified Detail screen, where you can inspect cast, ratings, and reviews, then tap Play or choose from Sources.

Do I need an account or sign-up to use 4789?

No. 4789 has no user registration, no server login, and no centralized database. Everything—including your watch position, catalog connections, and settings—is stored locally in your iPhone Keychain and device storage.

When you connect optional third-party services (like Trakt for watchlist sync), the connection talks directly from your phone to that service API over HTTPS. 4789 servers never sit in the middle.

Section 02

4789 for iPhone: Sideloading

Installing the IPA, enabling Developer Mode, and automatic 7-day refreshing.

How do I install the 4789 IPA on my iPhone?

Because 4789 is distributed as an open-source unsigned IPA, you install it using personal sideloading tools. We recommend SideStore for computer-free refreshes, or AltStore and Sideloadly:

01
Download the IPA: Visit the official GitHub releases page and download the latest FourSevenEightNine.ipa.
02
Open in SideStore or AltStore: In SideStore or AltStore, tap the + icon in the My Apps tab and select the downloaded IPA.
03
Sign with your Apple ID: The installer signs the application with your personal free developer certificate. Once installed, 4789 appears on your Home Screen.

First-Time Sideloaders

On iOS 16, 17, and 18, you must enable Developer Mode before sideloaded apps can launch.

How do I enable Developer Mode on iOS?

Apple requires Developer Mode to run sideloaded applications on iOS 16, 17, and 18. Here is the exact screen path:

iOS Settings Privacy & Security Developer Mode
01
Open the built-in iOS Settings app on your iPhone.
02
Scroll down and tap Privacy & Security.
03
Scroll to the bottom and tap Developer Mode. Toggle the switch to On.
04
Tap Restart when prompted. After the phone reboots, unlock it and tap Turn On on the confirmation alert.
What is the 7-day expiration and how does SideStore handle it?

Free Apple IDs sign applications with certificates valid for 7 days. If a certificate expires, the app will not launch until resigned.

With SideStore: Once installed, SideStore uses a local WireGuard VPN loopback to resign your apps directly on the iPhone over local Wi-Fi. You do not need to plug into a Mac or PC every week. Simply connect to Wi-Fi once every few days and SideStore refreshes 4789 in the background.

How do I update 4789 without losing my watch history or settings?

When updating, install the new IPA directly over the existing installation using the same Apple ID. iOS preserves the application container, including your watch progress, favorite lists, and stored preferences.

Safety Recommendation

Before updating, go to Settings Backup & Transfer Export settings and save a copy of your configuration to Files or iCloud Drive.

Section 03

Catalogs, Playback Services & Metadata

Connecting compatible services, Letterboxd shelves, and metadata enrichment.

What are the two essential setup steps on first launch?

When you first open 4789, the app presents a clean onboarding flow:

01
Connect a service to play: 4789 plays media through compatible playback services you connect. Choose your provider, paste your service key, and tap Test key. The key validates without revealing its characters and saves directly into the iOS Keychain.
02
Fill your shelves: Add a compatible catalog manifest or public list URL. Your Discover and Wall immediately populate with titles.

You can also choose Skip for now to explore the interface before connecting playback services.

How do I add compatible catalogs and add-on manifests?

4789 supports the open manifest specification for catalogs and subtitle services. To add one:

Settings Addons & Catalogs Add Addon
01
Open Settings from the Discover door.
02
Tap Addons & Catalogs.
03
Paste your compatible manifest URL (ending in manifest.json) into the input field and tap Add.
04
A green confirmation confirms the connection, and its shelves appear across Discover and the Wall immediately.
How do I connect public Letterboxd lists and friends?

You do not need a Letterboxd account or password. 4789 connects to any public Letterboxd profile:

Discover Letterboxd Lists Add Profile / List
01
In Discover, scroll to the Letterboxd Lists card and tap it.
02
Enter any public username or paste a direct public list link.
03
4789 pulls the watchlist, popular lists, and recent activity into dedicated shelves. When friends log reviews, titles surface directly in your New From Friends feed.
Where do I get an MDBList key and how does Trakt sync?

Under Settings Metadata & AI, you can connect enrichment providers:

  • MDBList: Enables source-labeled ratings (IMDb, Rotten Tomatoes, Metacritic, Trakt) and public list discovery. Get a free key at mdblist.com under Preferences ➔ API. Paste it and tap Test key.
  • Trakt: Tap Connect Trakt to authorize two-way history sync. Titles you watch in 4789 mark as watched on Trakt, and your Trakt watchlist populates in Discover.
How do I pull diverse lists (like Korean cinema or custom genres) into one unified library?

4789 makes it seamless to pull all your disparate film passions into one beautiful, unified cinema gallery:

01
Find or Create Your List: Locate any public list URL on Letterboxd or MDBList (for example, a curated Korean New Wave collection, A24 Horror, 90s Cyberpunk, or a director filmography).
02
Add as a Shelf: In 4789, go to Discover Letterboxd Lists Add Profile / List or connect an MDBList list feed under Metadata. Paste the URL and tap Add.
03
Automatic Metadata & Artwork: 4789 organizes the titles into a dedicated horizontal shelf in Discover and automatically weaves their high-res poster artwork into your Wall canvas. Synopsis, multi-critic ratings, and cast members populate instantly.

You can add as many lists as you wish, creating a deeply personalized media organizer that reflects your exact taste.

Section 04

4789 TV: Android TV, Google TV, Fire TV & Shield

Installing the dedicated TV receiver APK and unlocking permissions.

What is 4789 TV and what hardware does it support?

4789 TV is a standalone companion receiver application for your television. It turns your TV into a first-party playback destination that your iPhone can discover and control over local Wi-Fi.

Device Compatibility

Supported: Android TV, Google TV, NVIDIA Shield running Android 9+ (API 28+), and Fire TV devices running Fire OS 7 or later.
Not supported: Apple TV, Roku, Samsung Tizen, LG webOS, or Fire TVs running Vega OS.

How do I install 4789 TV using the Downloader app?

The fastest way to install on Android TV, Google TV, or Fire TV:

01
Install Downloader by AFTVnews from your TV app store.
02
Open Downloader and enter the quick-download code 5873252 (or type 4789library.com/tv). The verified APK download begins immediately.
03
When prompted, grant Downloader the Install unknown apps permission.
04
Select Install, then Open. Keep 4789 TV on screen so your iPhone can locate it.
How do I unlock Developer Options on Amazon Fire TV?

If Developer options is hidden on your Fire TV device:

Settings My Fire TV About Device Name
01
Highlight your device name in the About screen.
02
Press the remote center Select button 7 times until you see "No need, you are already a developer."
03
Press Back to return to the My Fire TV menu; Developer options is now visible.
04
Open Developer options ➔ Install unknown apps and toggle Downloader to On.
Can I install 4789 TV directly from my iPhone over Wi-Fi?

Yes! 4789 has an ADB installer built into the iOS app:

Settings Install on a TV
01
On your TV, enable ADB Debugging in Developer options. Note the TV IP address in Network settings.
02
On iPhone, navigate to Settings Install on a TV.
03
Enter the TV IP address. Your iPhone connects over ADB (port 5555), pushes the official receiver APK, and triggers package installation on the television.
04
Accept the on-screen authorization prompt on your TV. The receiver installs without requiring a computer!
Section 05

Casting, Play on TV & Link Casting

Moving playback between iPhone and TV while preserving position, tracks, and control.

How does casting work between iPhone and 4789 TV?

4789 uses a peer-to-peer local network protocol. When you tap Play on TV, your iPhone discovers the 4789 TV receiver via local broadcast and communicates directly using HTTP RPC (port 8791) and WebSocket sync (port 9791).

What is Link Casting?

Instead of battery-draining screen mirroring, 4789 sends the authenticated media URL and timing coordinates directly to the TV receiver. The television streams high-bitrate video directly over its own internet connection, while your iPhone becomes a responsive remote control.

Your iPhone can be locked, put in your pocket, or used for messaging while the film plays smoothly on the big screen.

Step-by-step: How do I cast a film or series to my TV?
01
Open 4789 TV on your television and leave the lobby screen visible.
02
On iPhone, open any movie or episode Detail page and tap Play on TV (or tap the Cast icon in the player).
03
Select your television from the destination picker. Playback launches immediately on the TV.
04
A glass Docked Cast Bar appears at the bottom of your iPhone screen across all views. Tap it to expand the full phone remote.
What controls are available on the iPhone remote while casting?

The docked cast remote provides full interactive control over the television session:

  • Precise scrubbing: Drag the playhead to any second with instant TV synchronization.
  • Jump buttons: Quick 10-second skip forward or back.
  • Track selection: Switch audio languages or change subtitle tracks without restarting the video.
  • Episode picker: Jump to the next episode directly from the remote sheet.
  • Switch sources: If a stream drops or buffers, open Sources from the remote and switch to a different file on the fly.
  • Physical TV remote sync: If someone uses the TV remote to pause or scrub, the iPhone remote updates in real time.
Can I bring playback back to my iPhone when leaving the room?

Yes. Tap the phone icon or choose Play on this iPhone in the remote. The TV stops, and playback resumes immediately on your phone at the exact second, with your chosen audio and subtitle tracks preserved.

How does 4789 TV compare to AirPlay, Chromecast, and Kodi?

4789 supports multiple TV routes, but 4789 TV provides the cleanest experience:

  • 4789 TV (Recommended): Direct MKV/HEVC container support, Dolby Vision tone mapping, multi-track audio bitstream passthrough, and bidirectional remote sync.
  • AirPlay: Great for natively compatible MP4/H.264 files; complex MKV files or stylized subtitles fall back to Screen Mirroring.
  • Chromecast: Supported via Google Cast SDK. Incompatible audio/video containers (like DTS or Dolby Vision) trigger an on-screen recommendation to use 4789 TV instead.
  • Kodi: Supported via JSON-RPC. Compatible with existing Kodi home theater setups.
Section 06

Player, Subtitles, Audio & Offline

Subtitle timing adjustments, audio bitstream routes, and downloading for offline travel.

What video formats and player features are supported on iPhone?

The iPhone player is powered by a high-performance native MPV/libmpv engine. It handles virtually any modern video file:

  • Containers & Codecs: MKV, MP4, MOV, WebM, H.264, HEVC/H.265, AV1, and VP9.
  • Color & Dynamic Range: Full HDR10, HLG, and Dolby Vision tone-mapping calibrated for OLED displays.
  • Playback Speeds: 0.5x, 0.75x, 1.0x, 1.25x, 1.5x, and 2.0x with pitch-preserved audio.
  • Background Play & PiP: Continue audio while navigating other apps or minimize into Picture-in-Picture.
How do I search for subtitles and adjust timing delay?

While a video is playing, tap the speech-bubble subtitle icon in the player bar:

01
Embedded tracks: Select any subtitle track packaged inside the video file (including SSA/ASS stylized formatting).
02
Search external subtitles: Tap Search Subtitles to fetch online subtitles matching your movie or episode in any language.
03
Adjust timing delay: Use the + and - delay controls to adjust sync in 50ms increments if speech and text drift.
04
Appearance: In Settings Playback Subtitles, customize text size, color, outline thickness, and background scrim.
How do I configure audio for TV speakers, soundbars, or AVR receivers?

On 4789 TV, open player settings during playback and select Audio Profile:

  • TV Speakers: High-quality stereo downmixing with dialog normalization.
  • ARC / Optical: Encodes multi-channel audio to Dolby Digital (AC3) or DTS for soundbars connected via standard HDMI ARC or TOSLINK optical cables.
  • eARC / AVR Passthrough: Bitstreams raw multi-channel audio (Dolby Atmos, TrueHD, DTS-HD Master Audio, and 7.1 LPCM) directly to an external A/V receiver for uncompressed sound.
How do offline video downloads work for travel?

Download movies or TV episodes to your iPhone to watch on flights or road trips with zero internet:

01
On any movie or episode Detail view, tap Sources.
02
Find a compatible stream option and tap the Download icon.
03
Track progress under Discover Downloads. When finished, downloaded titles play immediately with full subtitle and audio track switching without Wi-Fi or cellular data.
Can I import personal video files from the iOS Files app or a USB drive?

Yes. Go to Discover Local Files Import. Select any MKV, MP4, or MOV file from your iPhone storage, iCloud Drive, or a connected USB-C drive.

4789 matches filename metadata to fetch artwork and summary descriptions, and integrates the video directly into your library with resume tracking.

Section 07

For Content Creators & Reviewers

Elevator pitches, scripts, top features to film, and recording clean demo footage.

The 30-Second Pitch: How do I explain 4789 to an audience?

Use this concise script for YouTube Shorts, Instagram Reels, or TikTok videos:

"Stop jumping between five different streaming apps and copying movie titles into search bars. 4789 is a personal media player and library organizer for iPhone and TV. It plays your local video files, connects your personal media storage, and organizes your watchlists (like Korean cinema or Letterboxd lists) into one gorgeous poster gallery. There are zero accounts, no monthly fees, and zero ads. You browse an endless wall of poster art, get rich multi-critic ratings, discover fun Easter eggs, and cast straight to your TV in 4K with a live phone remote. It's the ultimate media player and organizer built for movie lovers."

Visual sequence to film: Show the dark Wall poster grid ➔ tap a poster ➔ tap Play on TV ➔ pan camera to television launching the video ➔ show the docked iPhone remote scrubbing the playhead.

What are the Top 5 visual moments to capture in a video review?

These specific features showcase best on camera:

01
The Poster Wall: Smooth 60fps scrolling through the ambient Wall view highlighting Pitch Black OLED mode.
02
Letterboxd Instant Sync: Typing a Letterboxd username and watching favorite films and friend reviews populate shelves in 2 seconds.
03
Sources Comparison: Dragging up the Sources panel showing real-time sorting by resolution (4K / 1080p), file size, codec, and provider badge.
04
Instant TV Handoff: Tapping Play on TV on iPhone and showing the TV receiver launch the stream without delay.
05
Docked Glass Remote: Showing the persistent glass remote on iPhone while the film plays on TV, adjusting subtitle delay in real time.
How do I record clean, demonetization-free demo footage?

Content creators must avoid copyright strikes and accidental credential leaks on camera:

  • Automatic Masked Keys: 4789 never reveals raw API keys or passwords on screen. Key fields remain masked with bullet characters during and after validation.
  • Public Domain Test Titles: For copyright-safe video clips that will not trigger ContentID, use classic public domain films like Night of the Living Dead (1968) or open-source Blender foundation films like Big Buck Bunny (CC BY 3.0).
  • Deterministic Demo Clips: Check out workflows.html to download approved 1080p video clips and poster frames for your B-roll.
How do journalists and creators get review access and press kits?

Email [email protected] with your publication, YouTube channel, or social handle and mention the devices you are reviewing on (e.g. iPhone 15 Pro, Fire TV Stick 4K Max, Shield TV).

The developer provides test builds, verified release artifacts, high-resolution vector logos, and screenshot mockups without watermarks.

Section 08

Settings, Backup, Security & Privacy

Where your keys live, handling settings exports, and restoring across devices.

Where are my API keys and configurations stored?

On iPhone, your service API keys and private URLs are encrypted in the system Apple Keychain. On Android TV, keys are encrypted using the Android Keystore hardware-backed security module.

These values are never stored on 4789 servers, analytics platforms, or iCloud backups unless you manually export them.

How do I export and transfer my settings to another device?
Settings Backup & Transfer Export settings
01
Open Settings and tap Backup & Transfer.
02
Tap Export settings. The iOS Share Sheet opens.
03
Save the JSON file to Files, iCloud Drive, or AirDrop it directly to another iPhone, iPad, or Mac.
04
On the destination device, open Settings Backup & Transfer Import settings and select the file. Your entire library, catalogs, and preferences restore in one tap!
Security Alert: How should I handle the exported settings file?

⚠️ Treat Exported Settings Like a Password

The exported 4789-settings.json file contains your live service keys, account tokens, and private catalog URLs so another device can restore them. Never post this file online, never share it on public forums or Discord, and never email it in support requests. Store it securely in a password manager or encrypted folder, and delete temporary copies after transferring.

Section 09

Troubleshooting & Common Hurdles

Quick fixes for "no sources", Wi-Fi discovery blocks, and playback errors.

Why do no sources appear when I open a title?

If the Sources list remains empty or Play does not start:

01
Check Key Validation: Go to Settings API Keys. Verify your playback service key shows a green test status. If red, re-copy the key from your provider account and tap Test key again.
02
Provider Subscription: Ensure your cloud debrid subscription is active and has not expired.
03
Check Catalogs: Go to Settings Addons & Catalogs to confirm your installed catalogs are answering.
04
Rare / Unreleased Titles: If a movie is not yet released or has no indexed digital streams, connected services will have zero playable files.
Why can’t my iPhone find the 4789 TV receiver?

If your television does not appear in the destination list:

01
Keep the TV App Open: Ensure 4789 TV is running in the foreground on your television.
02
Check iOS Permission: Open iOS Settings Privacy & Security Local Network and ensure 4789 is enabled.
03
Router AP / Client Isolation: Guest Wi-Fi and hotel networks intentionally block devices from communicating with each other. Use your standard private home Wi-Fi network.
04
VPN Interference: If a VPN is active on your iPhone or TV, it may tunnel local packets away. Temporarily disconnect the VPN or enable local LAN bypass.
05
Manual IP Connect: Read the IP address displayed on the 4789 TV receiver screen (e.g. 192.168.1.50). In the iPhone app, tap Add Receiver Manually and enter that IP address with default port 8791.
Why did the TV APK fail to install or give a signature error?

Common installation barriers on Android TV / Fire TV:

  • OS Version Floor: Verify your TV runs Android 9 (API 28) or Fire OS 7 or later in Settings ➔ About. Older devices (Android 8 / Fire OS 6) cannot parse the APK.
  • Signature Conflict: If you previously installed a debug test build, Android blocks installing official release builds over it due to mismatched signing keys. You must uninstall the previous test version first from Settings ➔ Apps.
  • Insufficient Storage: Ensure your television box has at least 300MB of free internal storage to unpack and install the app.
What should I do if 4K video buffers or audio drops frames?

Large 40GB+ 4K remuxes require high local bandwidth and decoder performance:

  • Network Bandwidth: Connect your TV via wired Ethernet or 5GHz Wi-Fi. 2.4GHz Wi-Fi frequently drops packets on 4K bitrates exceeding 60 Mbps.
  • Audio Decoder Overload: If your TV or soundbar does not support 7.1 TrueHD or DTS-HD, decoding complex audio in software can cause video stutter. In 4789 TV player settings, switch Audio Profile to Stereo PCM or ARC (AC3).
  • Pick an Optimized Source: On iPhone, tap Sources on the movie page and select an optimized 1080p or 4K WEB-DL file instead of an uncompressed Blu-ray remux.
How do I report a bug or get technical support?

We actively triage bug reports. Here is the best way to report an issue:

01
Gather Details: Note your exact iPhone or TV model, operating system version (e.g. iOS 18.1 or Fire OS 7.6), and the 4789 version.
02
Describe the Steps: Explain what you tapped, what you expected to happen, and what actually happened.
03
Submit Safely: Open an issue on GitHub or email [email protected]. Never include passwords, private API keys, or personal manifest URLs in bug reports or screenshots.

Still have a question?

Read our step-by-step visual guides or get in touch with the developer directly.

Support
[email protected]
Developer
Direct developer triage
No Account
Always 100% on-device