# Phyn Phyn, pronounced */fin/,* is a native multi-platform client for Jellyfin with a built-in music and video player that integrates seamlessly with your device's operating system. {% hint style="info" %} Phyn is a client application for Jellyfin. This means it does not come bundled with the Jellyfin server so you would need the [Jellyfin server](https://jellyfin.org) running to use it. {% endhint %} ## Features Here are the features of Phyn * [Native music playback support](/features/music-playback) * [Native video playback support](/features/video-playback) * [In-app notifications](/features/in-app-notifications) * Direct play almost any media codec * [Download videos to watch when not connected to your Jellyfin server](/features/watch-offline) * User friendly * Discover and add new movies and shows to your library (Jellyseerr server required). * Skip intros when watching shows (ConfusedPolarBear introskipper plugin required). {% hint style="info" %} Phyn has background media playback support and integrates nicely with the notification center of your device's OS so you can use it as your default music app. {% endhint %} ## Available platforms Phyn is available on only macOS, iOS, and Android. More support coming soon for other platforms. * [Android](https://play.google.com/store/apps/details?id=com.appsynergyts.phyn\&referrer=utm_source%3Dwebsite) * [iOS](https://apps.apple.com/app/apple-store/id6457674815?pt=120492921\&ct=docs.phyn.app\&mt=8) * [MacOS](https://apps.apple.com/app/apple-store/id6457674815?pt=120492921\&ct=docs.phyn.app\&mt=8) * AppleTV (coming soon) * Android TV (coming soon) # Music Playback Phyn supports native music playback. This means you can now play your music library on the go. It integrates nicely with your notification center or lock screen so that you can listen to music with the app in the background. {% hint style="info" %} The playing music displays album art on the lock screen. You should check it out. {% endhint %} # Video Playback Play your favorite TV shows and movies stored on your Jellyfin server with Phyn. If you are having issues playing any of the below codecs, please use the feedback button to let us know. {% hint style="warning" %} Before providing feedback, please check the *force direct play* toggle button in settings to be sure the video is actually supported by your device. If the video still doesn't play, then it means your device doesn't support it. {% endhint %} ## Supported codecs Below is an exhaustive list of codecs supported by Phyn. {% hint style="info" %} Playback does not depend on codec only. The container is also important {% endhint %} ``` 3dostr 3DO STR 4xm 4X Technologies aa Audible AA format files aac raw ADTS AAC (Advanced Audio Coding) aax CRI AAX ac3 raw AC-3 ace tri-Ace Audio Container acm Interplay ACM act ACT Voice file format adf Artworx Data Format adp ADP ads Sony PS2 ADS adx CRI ADX aea MD STUDIO audio afc AFC aiff Audio IFF aix CRI AIX alaw PCM A-law alias_pix Alias/Wavefront PIX image alp LEGO Racers ALP amr 3GPP AMR amrnb raw AMR-NB amrwb raw AMR-WB anm Deluxe Paint Animation apac raw APAC apc CRYO APC ape Monkey's Audio apm Ubisoft Rayman 2 APM apng Animated Portable Network Graphics aptx raw aptX aptx_hd raw aptX HD aqtitle AQTitle subtitles argo_asf Argonaut Games ASF argo_brp Argonaut Games BRP argo_cvg Argonaut Games CVG asf ASF (Advanced / Active Streaming Format) asf_o ASF (Advanced / Active Streaming Format) ass SSA (SubStation Alpha) subtitle ast AST (Audio Stream) au Sun AU av1 AV1 Annex B avi AVI (Audio Video Interleaved) avr AVR (Audio Visual Research) avs Argonaut Games Creature Shock avs2 raw AVS2-P2/IEEE1857.4 avs3 raw AVS3-P2/IEEE1857.10 bethsoftvid Bethesda Softworks VID bfi Brute Force & Ignorance bfstm BFSTM (Binary Cafe Stream) bin Binary text bink Bink binka Bink Audio bit G.729 BIT file format bitpacked Bitpacked bmp_pipe piped bmp sequence bmv Discworld II BMV boa Black Ops Audio bonk raw Bonk brender_pix BRender PIX image brstm BRSTM (Binary Revolution Stream) c93 Interplay C93 caf Apple CAF (Core Audio Format) cavsvideo raw Chinese AVS (Audio Video Standard) cdg CD Graphics cdxl Commodore CDXL video cine Phantom Cine codec2 codec2 .c2 demuxer codec2raw raw codec2 demuxer concat Virtual concatenation script cri_pipe piped cri sequence dash Dynamic Adaptive Streaming over HTTP data raw data daud D-Cinema audio dcstr Sega DC STR dds_pipe piped dds sequence derf Xilam DERF dfa Chronomaster DFA dfpwm raw DFPWM1a dhav Video DAV dirac raw Dirac dnxhd raw DNxHD (SMPTE VC-3) dpx_pipe piped dpx sequence dsf DSD Stream File (DSF) dshow DirectShow capture dsicin Delphine Software International CIN dss Digital Speech Standard (DSS) dts raw DTS dtshd raw DTS-HD dv DV (Digital Video) dvbsub raw dvbsub dvbtxt dvbtxt dxa DXA ea Electronic Arts Multimedia ea_cdata Electronic Arts cdata eac3 raw E-AC-3 epaf Ensoniq Paris Audio File exr_pipe piped exr sequence f32be PCM 32-bit floating-point big-endian f32le PCM 32-bit floating-point little-endian f64be PCM 64-bit floating-point big-endian f64le PCM 64-bit floating-point little-endian ffmetadata FFmpeg metadata in text film_cpk Sega FILM / CPK filmstrip Adobe Filmstrip fits Flexible Image Transport System flac raw FLAC flic FLI/FLC/FLX animation flv FLV (Flash Video) frm Megalux Frame fsb FMOD Sample Bank fwse Capcom's MT Framework sound g722 raw G.722 g723_1 G.723.1 g726 raw big-endian G.726 ("left aligned") g726le raw little-endian G.726 ("right aligned") g729 G.729 raw format demuxer gdigrab GDI API Windows frame grabber gdv Gremlin Digital Video gem_pipe piped gem sequence genh GENeric Header gif CompuServe Graphics Interchange Format (GIF) gif_pipe piped gif sequence gsm raw GSM gxf GXF (General eXchange Format) h261 raw H.261 h263 raw H.263 h264 raw H.264 video hca CRI HCA hcom Macintosh HCOM hdr_pipe piped hdr sequence hevc raw HEVC video hls Apple HTTP Live Streaming hnm Cryo HNM v4 ico Microsoft Windows ICO idcin id Cinematic idf iCE Draw File iff IFF (Interchange File Format) ifv IFV CCTV DVR ilbc iLBC storage image2 image2 sequence image2pipe piped image2 sequence imf IMF (Interoperable Master Format) ingenient raw Ingenient MJPEG ipmovie Interplay MVE ipu raw IPU Video ircam Berkeley/IRCAM/CARL Sound Format iss Funcom ISS iv8 IndigoVision 8000 video ivf On2 IVF ivr IVR (Internet Video Recording) j2k_pipe piped j2k sequence jacosub JACOsub subtitle format jpeg_pipe piped jpeg sequence jpegls_pipe piped jpegls sequence jpegxl_pipe piped jpegxl sequence jv Bitmap Brothers JV kux KUX (YouKu) kvag Simon & Schuster Interactive VAG laf LAF (Limitless Audio Format) lavfi Libavfilter virtual input device live_flv live RTMP FLV (Flash Video) lmlm4 raw lmlm4 loas LOAS AudioSyncStream lrc LRC lyrics luodat Video CCTV DAT lvf LVF lxf VR native stream (LXF) m4v raw MPEG-4 video matroska,webm Matroska / WebM mca MCA Audio Format mcc MacCaption mgsts Metal Gear Solid: The Twin Snakes microdvd MicroDVD subtitle format mjpeg raw MJPEG video mjpeg_2000 raw MJPEG 2000 video mlp raw MLP mlv Magic Lantern Video (MLV) mm American Laser Games MM mmf Yamaha SMAF mods MobiClip MODS moflex MobiClip MOFLEX mov,mp4,m4a,3gp,3g2,mj2 QuickTime / MOV mp3 MP2/3 (MPEG audio layer 2/3) mpc Musepack mpc8 Musepack SV8 mpeg MPEG-PS (MPEG-2 Program Stream) mpegts MPEG-TS (MPEG-2 Transport Stream) mpegtsraw raw MPEG-TS (MPEG-2 Transport Stream) mpegvideo raw MPEG video mpjpeg MIME multipart JPEG mpl2 MPL2 subtitles mpsub MPlayer subtitles msf Sony PS3 MSF msnwctcp MSN TCP Webcam stream msp Microsoft Paint (MSP)) mtaf Konami PS2 MTAF mtv MTV mulaw PCM mu-law musx Eurocom MUSX mv Silicon Graphics Movie mvi Motion Pixels MVI mxf MXF (Material eXchange Format) mxg MxPEG clip nc NC camera feed nistsphere NIST SPeech HEader REsources nsp Computerized Speech Lab NSP nsv Nullsoft Streaming Video nut NUT nuv NuppelVideo obu AV1 low overhead OBU ogg Ogg oma Sony OpenMG audio paf Amazing Studio Packed Animation File pam_pipe piped pam sequence pbm_pipe piped pbm sequence pcx_pipe piped pcx sequence pfm_pipe piped pfm sequence pgm_pipe piped pgm sequence pgmyuv_pipe piped pgmyuv sequence pgx_pipe piped pgx sequence phm_pipe piped phm sequence photocd_pipe piped photocd sequence pictor_pipe piped pictor sequence pjs PJS (Phoenix Japanimation Society) subtitles pmp Playstation Portable PMP png_pipe piped png sequence pp_bnk Pro Pinball Series Soundbank ppm_pipe piped ppm sequence psd_pipe piped psd sequence psxstr Sony Playstation STR pva TechnoTrend PVA pvf PVF (Portable Voice Format) qcp QCP qdraw_pipe piped qdraw sequence qoi_pipe piped qoi sequence r3d REDCODE R3D rawvideo raw video realtext RealText subtitle format redspark RedSpark rka RKA (RK Audio) rl2 RL2 rm RealMedia roq id RoQ rpl RPL / ARMovie rsd GameCube RSD rso Lego Mindstorms RSO rtp RTP input rtsp RTSP input s16be PCM signed 16-bit big-endian s16le PCM signed 16-bit little-endian s24be PCM signed 24-bit big-endian s24le PCM signed 24-bit little-endian s32be PCM signed 32-bit big-endian s32le PCM signed 32-bit little-endian s337m SMPTE 337M s8 PCM signed 8-bit sami SAMI subtitle format sap SAP input sbc raw SBC (low-complexity subband codec) sbg SBaGen binaural beats script scc Scenarist Closed Captions scd Square Enix SCD sdns Xbox SDNS sdp SDP sdr2 SDR2 sds MIDI Sample Dump Standard sdx Sample Dump eXchange ser SER (Simple uncompressed video format for astronomical capturing) sga Digital Pictures SGA sgi_pipe piped sgi sequence shn raw Shorten siff Beam Software SIFF simbiosis_imx Simbiosis Interactive IMX sln Asterisk raw pcm smjpeg Loki SDL MJPEG smk Smacker smush LucasArts Smush sol Sierra SOL sox SoX native spdif IEC 61937 (compressed data in S/PDIF) srt SubRip subtitle stl Spruce subtitle format subviewer SubViewer subtitle format subviewer1 SubViewer v1 subtitle format sunrast_pipe piped sunrast sequence sup raw HDMV Presentation Graphic Stream subtitles svag Konami PS2 SVAG svg_pipe piped svg sequence svs Square SVS swf SWF (ShockWave Flash) tak raw TAK tedcaptions TED Talks captions thp THP tiertexseq Tiertex Limited SEQ tiff_pipe piped tiff sequence tmv 8088flex TMV truehd raw TrueHD tta TTA (True Audio) tty Tele-typewriter txd Renderware TeXture Dictionary ty TiVo TY Stream u16be PCM unsigned 16-bit big-endian u16le PCM unsigned 16-bit little-endian u24be PCM unsigned 24-bit big-endian u24le PCM unsigned 24-bit little-endian u32be PCM unsigned 32-bit big-endian u32le PCM unsigned 32-bit little-endian u8 PCM unsigned 8-bit v210 Uncompressed 4:2:2 10-bit v210x Uncompressed 4:2:2 10-bit vag Sony PS2 VAG vbn_pipe piped vbn sequence vc1 raw VC-1 vc1test VC-1 test bitstream vfwcap VfW video capture vidc PCM Archimedes VIDC vividas Vividas VIV vivo Vivo vmd Sierra VMD vobsub VobSub subtitle format voc Creative Voice vpk Sony PS2 VPK vplayer VPlayer subtitles vqf Nippon Telegraph and Telephone Corporation (NTT) TwinVQ w64 Sony Wave64 wady Marble WADY wav WAV / WAVE (Waveform Audio) wavarc Waveform Archiver wc3movie Wing Commander III movie webm_dash_manifest WebM DASH Manifest webp_pipe piped webp sequence webvtt WebVTT subtitle wsaud Westwood Studios audio wsd Wideband Single-bit Data (WSD) wsvqa Westwood Studios VQA wtv Windows Television (WTV) wv WavPack wve Psion 3 audio xa Maxis XA xbin eXtended BINary text (XBIN) xbm_pipe piped xbm sequence xmd Konami XMD xmv Microsoft XMV xpm_pipe piped xpm sequence xvag Sony PS3 XVAG xwd_pipe piped xwd sequence xwma Microsoft xWMA yop Psygnosis YOP yuv4mpegpipe YUV4MPEG pipe ``` # Watch offline Leaving your home or traveling and eaving your Jellyfin server behind? No worries. You can download your movies and TV Shows onto your device to watch later when in transit or anything. {% hint style="warning" %} When watching your media offline, play status and watch status will not sync to the server. {% endhint %} # In-app notifications Experience seamless integration and stay informed about your media library with Phyn's in-app notifications feature. Receive instant updates from both Jellyfin and Jellyseerr, ensuring you never miss out on new content additions. Configure your notifications effortlessly and enjoy a heightened media experience with Phyn. [Check out our guide](/guides/how-to-receive-in-app-notifications) on how to configure in-app notifications in Phyn. # Ebooks * [x] iOS * [x] Android * [x] macOS {% hint style="info" %} Phyn supports all popular ebook formats - EPUB, CBR, CBZ and PDF. {% endhint %} Phyn, your go-to media management app, is now even more versatile with the introduction of eBook support. If you're a Jellyfin user, Phyn brings your eBook library right to your fingertips, offering a seamless way to read and manage your books alongside your other media content. **Access Your eBooks Hosted on Jellyfin** With Phyn, your eBooks stored on your Jellyfin server are easily accessible wherever you are. There's no need to juggle multiple apps to manage your digital reading collection—Phyn integrates directly with your Jellyfin server, allowing you to browse, select, and read eBooks without hassle. Whether you prefer EPUB, PDF, CBR, or CBZ formats, Phyn supports a variety of eBook types, making it simple to enjoy your reading material, no matter the format. **Seamless Reading Experience** Phyn’s interface is designed to provide a smooth reading experience. Once connected to your Jellyfin server, you can dive straight into your eBooks. Bookmarks and annotations are also supported, so you can easily keep track of your progress and jot down thoughts or important points directly within the app. **Unified Media Management** One of the standout features of Phyn is its ability to unify all your media in one place. With eBook support, Phyn enhances this experience, allowing you to manage and access your movies, music, and books from your Jellyfin server all within a single app. **Cross-Platform Convenience** Phyn ensures that your eBook library is accessible across all your devices. Whether you’re at home on your desktop or on the move with your smartphone or tablet, Phyn keeps your Jellyfin-hosted eBooks synced and ready to read. # Live TV & Program Guide ## Phyn brings the classic television experience into the modern era with full support for **Jellyfin Live TV**. Whether you're catching the local news, watching a live sporting event, or browsing your favorite cable channels, Phyn provides a rich, colorful, and intuitive interface to manage your live broadcasts. ### How to Access Live TV There are two primary ways to jump into your live streams quickly: 1. **Side Navigation Menu:** Open the side drawer (where your Movies and TV libraries are listed) and select **Live TV**. This will take you to the main Live TV landing page. 2. **Home Page:** Look for the **"On Air Now"** row directly on your Phyn homescreen for instant access to top-trending live content without any extra clicks. ### A Rich & Colorful Guide 🎨 Once you enter the Live TV section, you are greeted with a high-fidelity **Electronic Program Guide (EPG)**. * **On Air Now:** The landing page of the Live TV menu immediately showcases what is currently broadcasting across all your channels. * **Visual Discovery:** Phyn uses rich channel logos and colorful program posters to make browsing through the schedule a visual delight. * **Program Details:** Tap on any upcoming show to see a detailed synopsis, air times, and cast information. ### Key Features #### Instant Playback See something you like on the "On Air Now" row? Tap it to start the stream instantly. Phyn’s native player handles live streams with minimal buffering, ensuring you don't miss a second of the action. #### Multitasking with PiP On supported devices, you can use **Picture-in-Picture** to keep your live game or news broadcast running in a small window while you browse other libraries or use different apps. #### Native Controls Adjust audio tracks or toggle subtitles for live broadcasts directly within the player interface, just as you would with your local movie files. ### Setting Up Live TV on Your Server ⚙️ Please note that Phyn is a client application and does not provide TV channels itself. You must configure the Live TV source (such as an HDHomeRun, M3U tuner, or IPTV provider) on your Jellyfin server first. For a detailed walkthrough on how to set up tuners and XMLTV listings on your server, please refer to the official Jellyfin documentation: 👉 [**Jellyfin Live TV Setup Guide**](https://jellyfin.org/docs/general/server/live-tv/) ### Troubleshooting * **"Live TV" is missing from my menu:** Ensure that your Jellyfin user account has "Enable Live TV" permissions checked in the server's dashboard. * **No guide data is appearing:** Verify that your XMLTV or electronic guide source is correctly mapped within the Jellyfin server settings. * **Playback Issues:** If a live stream is lagging, it may be due to server transcoding. Try adjusting the playback quality in the Phyn player settings. **Need more help?** If you have questions about the Live TV interface or encounter a bug, use the **Live Chat** bubble at the bottom of our website or email us at . # How to: Receive in-app notifications Notifications are a crucial aspect of staying updated and informed about new content added to your media library. Phyn allows you to receive notifications from Jellyfin and Jellyseerr. In this walkthrough, we'll guide you through the process of configuring notifications from both Jellyfin and Jellyseerr. {% hint style="info" %} **Notify all devices**: This will give you a URL that can be used to notify all the devices you own that have Phyn installed. This may be useful if you use Phyn on multiple devices. **Notify this device**: This will give you a URL that can be used to notify only the current device the URL was copied from. This is useful if you do not want to be getting notifications on multiple devices. {% endhint %} ## Configuring Jellyfin Notifications Phyn uses webhooks to receive notifications from Jellyfin. You can use any plugin that supports webhooks so far you use it with the default notification template. This tutorial uses the [Jellyfin webhook plugin](https://github.com/jellyfin/jellyfin-plugin-webhook) to receive in-app notifications. The notifications are instant and non-intrusive. Follow these steps to configure the Jellyfin webhook plugin to receive notifications in Phyn: {% hint style="info" %} Right now, only ***item added*** and ***generic*** notifications are supported. Custom templates are not supported. {% endhint %} {% hint style="warning" %} While technically, you can use Phyn with any plugin that supports webhook notifications, Phyn was only tested with the [Jellyfin webhook plugin](https://github.com/jellyfin/jellyfin-plugin-webhook) so it is the only one that is guaranteed to work. The others may or may not work correctly. {% endhint %} #### Getting the webhook URL 1. Open the Phyn app and navigate to ***settings***. 2. Under the notifications section, select either ***Notify all devices*** or ***Notify this device***. A URL will be copied for you. We will use this URL to configure the webhook plugin on Jellyfin. #### Configuring the webhook plugin on Jellyfin If you haven't already, you should install the [Jellyfin webhook plugin](https://github.com/jellyfin/jellyfin-plugin-webhook) for the next steps. {% hint style="info" %} To perform these actions, you need admin access to your server. If you do not have admin access, reach out to an admin to help you out. {% endhint %} 1. Login into your Jellyfin server on the web 2. Go to plugins -> my plugins 3. Find the Webhook plugin and click on it 4. Click on ***Add generic destination*** 5. Enter the Phyn (or any name you want) in the webhook name. 6. Paste the URL copied from the Phyn app in the webhook URL. 7. Select all the notification types you want to receive. For now, it is only the ***Item added*** and ***Generic*** notification types are supported. If you would like a particular type to be added, please send an email to or use the ***Report issue*** feature in the app. 8. Select the user under the ***User filter***. You will only get notifications from the user you select 9. Under ***Item type***, select the items you are interested in receiving notifications for. 10. Make sure you select ***Send All Properties (ignores template)***. Phyn currently does not support custom notification templates. 11. Click on save Congratulations! You have successfully configured notifications from Jellyfin to Phyn. ## Configuring Notifications from Jellyseerr Jellyseerr is another platform that you can integrate with Phyn to receive notifications effectively. Follow these steps to configure notifications from Jellyseerr: #### Getting the webhook URL 1. Open the Phyn app and navigate to ***settings***. 2. Link your Jellyseerr account to Phyn under ***Linked services*** 3. Under the ***Jellyseerr settings*** section, select either ***Notify all devices*** or ***Notify this device***. A URL will be copied for you. We will use this URL to configure the webhook notifications Jellyseerr. #### Configuring the webhook notifications on Jellyseerr {% hint style="info" %} To perform these actions, you need admin access to your server. If you do not have admin access, reach out to an admin to help you out. {% endhint %} 1. Login into your Jellyseerr server on the web 2. Go to settings -> notifications 3. On the notifications page, click on the ***Webhook*** item. It should be the last on the list. Now, this is where will will be configuring the webhook URL we got in the previous step to receive notifications. 4. Select ***Enable Agent.*** 5. Paste the copied URL in the ***Webhook URL*** 6. Leave ***JSON Payload*** as it is. If you have previously modified it, you can use the *reset button* below to reset it. Phyn only works with the default payload, tampering with it may make it not work properly. 7. Select the notification types you want to receive. All notification types are supported. 8. Click on Test to test the notifications. You should receive a test notification. If you don't check that the webhook URL is correct or reset the payload to default. 9. Click on save. You have now successfully configured notifications from Jellyseerr to Phyn. With notifications configured from both Jellyfin and Jellyseerr, you'll receive timely updates and stay informed about relevant activities within Phyn. Enjoy your enhanced user experience! # How To: View media codec information (videos) ### Introduction In this guide, you'll learn how to view detailed codec information for video files within the app. Whether you're browsing your movie or TV series library, accessing this information is straightforward. Follow the steps below to retrieve codec details for any video. {% hint style="info" %} This guide is particularly useful if you want to reach out to support about a movie not playing or any issues with playback. {% endhint %} ### Step-by-Step Instructions #### Viewing Codec Information for Movies 1. **Navigate to the Home Screen**: Start by opening the app and ensuring you are on the Home Screen. 2. **Access Your Movie Library**: Navigate to your movie collection on the side menu or from your home screen. 3. **Select a Movie**: Choose the movie you wish to view detailed information for. 4. **Locate the Item Menu**: Once you have selected a movie, on the next screen which shows the details of the movie, you'll see a list of icons below the movie's title. The last icon on the right, which looks like three dots stacked vertically (⋮), represents the item menu. It should be just after the *favorite* and *mark as watched* icons. 5. **Open the Overflow Menu**: Tap on the item menu icon (⋮) to reveal an overflow menu. 6. **Select "Media Info"**: In the overflow menu, scroll to the last item labeled *"Media Info"* and select it. This acton will open the detailed codec information for the selected movie. #### Viewing Codec Information for TV Series 1. **Navigate to the Home Screen**: Start by opening the app and ensuring you are on the Home Screen. 2. **Access Your TV Series Library**: Navigate to your TV Series collection on the side menu or from your home screen. 3. **Select a TV Series**: Choose the series you wish to view detailed information for. 4. **Select an Episode**: After selecting the series, choose an episode from the list. This should open the details about the episode. 5. **Locate the Item Menu**: Below the episode's title, you'll see a list of icons. The last icon on the right, which looks like three dots stacked vertically (⋮), represents the item menu. It should be just after the *favorite* and *mark as watched* icons. 6. **Open the Overflow Menu**: Tap on the item menu icon (⋮) to reveal an overflow menu. 7. **Select "Media Info"**: In the overflow menu, scroll to the last item labeled "Media Info" and select it. This will open the detailed codec information for the selected episode. #### Conclusion Now you know how to easily access and view the codec information for any video within your app. Whether it's a movie or a TV series episode, the process is quick and intuitive, allowing you to access the technical details of your media effortlessly. # How To: Customizing Phyn App Homescreen The Phyn app allows you to personalize your homescreen by reorganizing sections and enabling or disabling content blocks, ensuring your most-interesting content are always at your fingertips. ### Step-by-Step Guide: #### 1. Access the Main Menu from the Homescreen From the Phyn app's homescreen, tap on your account icon in the top right corner. This will open the main account menu.

Tap on your account icon in the top right corner

#### #### 2. Navigate to Settings In the account menu that appears, locate and tap on "**Settings**" to access the app's configuration options.

Tap on "Settings" to access the app's configuration options

#### #### 3. Select "Customize Home screen" Within the Settings menu, under "**Appearance & Interface**," you'll find the "**Customize Home screen**" option. Tap on this to begin personalizing your homescreen layout.

Customize Home screen

#### #### 4. Reorganize and Disable Homescreen Sections On the "Customize Home screen" page, you have two primary ways to tailor your homescreen: * Reorganize Sections: Use the up and down arrow icons at the right next to each section to move it higher or lower on your homescreen. This allows you to prioritize the content you see first. * Enable/Disable Sections: Use the checkboxes at the left next to each section name to either enable (checked) or disable (unchecked) its appearance on your homescreen. Uncheck sections you don't frequently use to declutter your view.
# Delete downloaded TV Shows/Movies This guide provides step by step instructions on how to delete downloaded TV Shows and movies One of the most used features of Phyn is the ability to download and watch movies or TV shows when not connected to your server. However, this can significantly increase the usage of your device storage space. With a few taps, you can declutter your library by removing movies or TV shows that you've already watched or no longer need. Here's a simple guide on how to delete titles from your streaming app library. #### Step by step instructions 1. **Navigate to Your Downloads Section**: Access the downloads section from the navigation menu. 2. **Select the Content to Delete:** If it is a TV Show, tap on it to navigate to the episode otherwise skip to step. 3. **Access the Delete Option:** Tap the overflow menu button to reveal the delete menu. 4. **Delete the movie/show:** Tap on the delete menu to delete the media file 5. **Confirm Deletion**: You would see a message telling you the item has been deleted. The item is deleted when this message disappears, this means you can still reverse the action by clicking the *undo* button. [***To ensure deletion happens, wait for the message to disappear before exiting***](#user-content-fn-1)[^1]*.* {% hint style="danger" %} The deletion happens when the *item deleted* message disappears. So, you must wait for the message to disappear if you want to proceed with the deletion. {% endhint %} Find below photos of the above instructions.

Delete downloaded files

[^1]: # I am unable to play a video While Phyn performs better than most Jellyfin clients in terms of video codec support, there may still be some video codecs that were missed during configuration. If you are sure your device supports a particular codec but you are unable to play it with phyn, please reach out to us and we will get on it right away. {% hint style="info" %} In settings on Phyn app, use the force direct play button to test if the particular video plays just fine. Please tell us the result of this test so that we know how to proceed. {% endhint %} # How to Redeem Promo Codes on the Phyn Promo codes can be a great way to access premium features or discounts within apps. If you're a user of the Phyn app on Android or iOS, redeeming promo codes is simple. Follow this step-by-step guide to enjoy the benefits your promo codes provide. *** ### For Android Users #### Step 1: Open the Phyn App Locate the Phyn app icon on your Android device and tap on it to open the app. Connect to your Jellyfin server and login if needed. #### Step 2: Access the Navigation drawer Once logged in, look for the hamburger icon (usually three lines) at the top left of the screen and tap it to reveal the app’s navigation drawer. The navigation drawer contains the ***Home*** menu as well as your library menu. On smaller devices, it is hidden by default but it is visible on larger devices. #### Step 3: Go to 'Premium' In the drawer, look for the ***Premium*** menu, it should be the last menu item in the list. This menu will not be visible if you already have a premium subscription. #### Step 4: Select a subscription Select the relevant subscription and click ***continue***. This will take you to the payment page. Once there, select ***redeem code*** and enter the code on the next page*.* #### Step 5: Redeem the Code After entering the code, tap the 'Redeem' button. If the code is valid, you will see a confirmation message, and the associated benefits will be applied to your account. #### Step 6: Enjoy the Perks Enjoy the new features or discounts that the promo code has unlocked! {% hint style="info" %} There are various types of promo codes redeemable. Please read the details and conditions presented to you by Google Play before you proceed with redeeming any of them. {% endhint %} *** ### For iOS, iPadOS and macOS Users For Apply devices, it is a bit different. Promo codes are redeemed on the App Store. {% hint style="info" %} Ensure you [download Phyn](https://apps.apple.com/app/apple-store/id6457674815?pt=120492921\&ct=docs.phyn.app\&mt=8) first to redeem the codes. {% endhint %} #### Step 1: Open the App Store Locate and tap on the App Store icon on your iOS device to open it. #### Step 2: Navigate to 'Apps' Once the App Store is open, tap on the 'Apps' icon located at the bottom center of the screen. #### Step 3: Scroll and Redeem Scroll down within the 'Apps' section until you find the 'Redeem' option. Tap on it. #### Step 4: Manual Code Entry Tap on 'You can also redeem your code manually' to proceed to the code redemption screen. #### Step 5: Follow the Prompts Enter your promo code as prompted and follow any additional instructions provided to redeem your code. #### Additional Information that Please note, if you redeem a promo code, you will not be able to leave a review for the app or the in-app purchase. *** Remember to make sure that your iOS device is connected to the internet and that you're signed in with your Apple ID that you want to redeem the code with. If you encounter any issues, double-check the code for accuracy, ensuring there are no mistakes, and make sure the code hasn’t expired. If problems persist, contacting Apple Support might be necessary. Enjoy your app or in-app purchase! *** ### Troubleshooting Tips * **Invalid Code**: If your promo code isn't working, check for any input errors or expiration dates. *** Happy savings, and enjoy your Phyn app experience! # Managing Your Phyn Subscription This guide provides a clear overview of Phyn Premium features. It includes step-by-step instructions for managing or canceling your subscription through the Apple App Store or Google Play Store. ## Phyn is committed to providing a premium, native experience for your self-hosted media. While basic library browsing and media streaming are free, **Phyn Premium** unlocks the full potential of your "Personalized Media Haven," enabling advanced features that bridge the gap between your server and your mobile lifestyle. ### Subscription Tiers & Benefits We offer flexible plans to suit every type of media enthusiast. Whether you prefer a low monthly entry point or the "set it and forget it" convenience of lifetime access, there is a plan for you. | **Feature** | **Free Version** | **Phyn Premium** | | --------------------------------- | ---------------- | ---------------- | | Native Media Streaming | ✅ | ✅ | | Video Playback | ✅ | ✅ | | Music Playback | ✅ | ✅ | | **Resume Playback** | ❌ | ✅ | | **Offline Downloads** | ❌ | ✅ | | **Advanced eBook Navigation** | ❌ | ✅ | | **Early Access to New Features** | ❌ | ✅ | | Plugin Support (Jellyseerr/Trakt) | ❌ | ✅ | | Calendar | ❌ | ✅ | #### Our Plans * **Monthly:** Ideal for trying out the full suite of features. * **Yearly:** Our most popular plan, offering a significant discount over the monthly rate. * **Lifetime Access:** A one-time payment for permanent access to all current and future Phyn features. No recurring fees, ever. ### How to Subscribe or Upgrade You can manage your subscription directly within the Phyn app on your preferred device. 1. **Open Phyn** and tap the **Settings** (gear) icon. 2. Navigate to the **Account & Subscription** section. 3. Choose your preferred plan and complete the purchase through the **App Store (iOS/macOS)** or **Google Play Store (Android)**. ### Managing Your Subscription (Cancellations & Refunds) Since Phyn uses the native payment systems of your device’s operating system, all billing, renewals, and cancellations are handled securely by Apple or Google. #### On iOS and macOS 1. Open the **Settings** app on your device. 2. Tap your **Name/Apple ID** at the very top. 3. Tap **Subscriptions**. 4. Find **Phyn** in the list to change your plan or cancel your renewal. #### On Android 1. Open the **Google Play Store** app. 2. At the top right, tap the **profile icon**. 3. Tap **Payments & subscriptions** > **Subscriptions**. 4. Select **Phyn** to manage your billing cycle or cancel. ### Common Questions (FAQ) #### "Can I use my subscription on multiple devices?" Yes! As long as you are signed into the same App Store or Google Play account, your Phyn Premium status will follow you across all your devices on that platform. #### "How do I Restore Purchases?" If you've upgraded but don't see your Premium features active: 1. Go to **Settings** in the Phyn app. 2. Tap **Account & Subscription**. 3. Select **Restore Purchases**. This will re-verify your receipt with the App Store or Google Play Store. #### "Do I need a subscription to use my Jellyfin server?" No. Your Jellyfin server is yours, and Phyn will always allow you to connect to it and stream your content for free. The subscription only unlocks the "enhanced" native features developed specifically by the Phyn team, such as offline downloads and advanced syncing. **Still have billing questions?** If you are having trouble with a specific transaction or need help with a refund request, please contact us at . Please include your **Order ID** from Apple or Google to help us assist you faster. # Casting to Your TV (AirPlay & Google Cast) 📺 This guide covers how to bring Phyn to the big screen using AirPlay and Google Cast. It includes step-by-step setup for Apple TV and Chromecast and offers quick troubleshooting tips. ## Phyn is designed to bring a cinematic experience to every screen you own. Even if you are using Phyn on your mobile device or tablet, you can easily "throw" your media onto the big screen using our built-in support for **AirPlay** and **Google Cast**. ### How to Use AirPlay (Apple TV & Compatible TVs) If you have an Apple TV or an AirPlay-enabled Smart TV, you can stream high-quality video and audio directly from Phyn on your iPhone, iPad, or Mac. 1. **Connect to Wi-Fi:** Ensure your device and your TV/Apple TV are on the same wireless network. 2. **Start Playback:** Open a movie, show, or song in Phyn. 3. **Tap the Cast Icon:** Look for the **AirPlay** icon (a rectangle with a triangle at the bottom) within the Phyn media player. 4. **Select Your Device:** Choose your Apple TV or compatible TV from the list. Your media will begin playing on the TV, and you can continue to use Phyn as a remote to control playback, volume, and subtitles. ✨ ### How to Use Google Cast (Chromecast & Android TV) Phyn also supports Google Cast, allowing you to stream to Chromecasts, Android TV boxes, and built-in Google Cast televisions. 1. **Connect to Wi-Fi:** Make sure your mobile device and Chromecast/Android TV are on the same network. 2. **Locate the Cast Icon:** While playing media, tap the **Google Cast** icon (a rectangle with signal waves in the corner). 3. **Choose Your Screen:** Select your target device from the list. Once connected, Phyn will "hand off" the stream to your TV for a smooth, lag-free viewing experience. ### Benefits of Casting with Phyn * **Native Performance:** Phyn utilizes the highest quality streams available on your server to ensure your TV picture is crisp and vibrant. * **Multitasking:** Once you start casting, you can often use other apps on your phone or even lock your screen without interrupting the movie. * **Remote Control:** Use your device to skip intros, adjust volume, or change audio tracks effortlessly. ### Troubleshooting #### "I don't see the Cast/AirPlay icon" * **Network Check:** 90% of casting issues are solved by ensuring both devices are on the exact same Wi-Fi frequency (e.g., both on the 5GHz band). * **Permission Check:** (iOS Users) Go to your device **Settings > Phyn** and ensure "Local Network" access is toggled **ON**. #### "The video is lagging on the TV" * **Server Transcoding:** If your server is struggling to transcode the file for the TV, try lowering the "Quality" setting in the Phyn player menu. * **Direct Play:** Phyn aims to "Direct Play" whenever possible to avoid lag, but this depends on the formats your specific TV model supports. **Need more help getting Phyn on the big screen?** Reach out to us via the **Live Chat** bubble at the bottom of our website or email . # Direct play on supported platforms Phyn supports direct play of the below codecs. If you notice that yours does not, Please use the feedback button in the app to reach out. {% hint style="warning" %} Before providing feedback, please check the *force direct play* toggle button in settings to be sure the video is actually supported by your device. If the video still doesn't play, then it means your device doesn't support it. {% endhint %} ``` 3dostr 3DO STR 4xm 4X Technologies aa Audible AA format files aac raw ADTS AAC (Advanced Audio Coding) aax CRI AAX ac3 raw AC-3 ace tri-Ace Audio Container acm Interplay ACM act ACT Voice file format adf Artworx Data Format adp ADP ads Sony PS2 ADS adx CRI ADX aea MD STUDIO audio afc AFC aiff Audio IFF aix CRI AIX alaw PCM A-law alias_pix Alias/Wavefront PIX image alp LEGO Racers ALP amr 3GPP AMR amrnb raw AMR-NB amrwb raw AMR-WB anm Deluxe Paint Animation apac raw APAC apc CRYO APC ape Monkey's Audio apm Ubisoft Rayman 2 APM apng Animated Portable Network Graphics aptx raw aptX aptx_hd raw aptX HD aqtitle AQTitle subtitles argo_asf Argonaut Games ASF argo_brp Argonaut Games BRP argo_cvg Argonaut Games CVG asf ASF (Advanced / Active Streaming Format) asf_o ASF (Advanced / Active Streaming Format) ass SSA (SubStation Alpha) subtitle ast AST (Audio Stream) au Sun AU av1 AV1 Annex B avi AVI (Audio Video Interleaved) avr AVR (Audio Visual Research) avs Argonaut Games Creature Shock avs2 raw AVS2-P2/IEEE1857.4 avs3 raw AVS3-P2/IEEE1857.10 bethsoftvid Bethesda Softworks VID bfi Brute Force & Ignorance bfstm BFSTM (Binary Cafe Stream) bin Binary text bink Bink binka Bink Audio bit G.729 BIT file format bitpacked Bitpacked bmp_pipe piped bmp sequence bmv Discworld II BMV boa Black Ops Audio bonk raw Bonk brender_pix BRender PIX image brstm BRSTM (Binary Revolution Stream) c93 Interplay C93 caf Apple CAF (Core Audio Format) cavsvideo raw Chinese AVS (Audio Video Standard) cdg CD Graphics cdxl Commodore CDXL video cine Phantom Cine codec2 codec2 .c2 demuxer codec2raw raw codec2 demuxer concat Virtual concatenation script cri_pipe piped cri sequence dash Dynamic Adaptive Streaming over HTTP data raw data daud D-Cinema audio dcstr Sega DC STR dds_pipe piped dds sequence derf Xilam DERF dfa Chronomaster DFA dfpwm raw DFPWM1a dhav Video DAV dirac raw Dirac dnxhd raw DNxHD (SMPTE VC-3) dpx_pipe piped dpx sequence dsf DSD Stream File (DSF) dshow DirectShow capture dsicin Delphine Software International CIN dss Digital Speech Standard (DSS) dts raw DTS dtshd raw DTS-HD dv DV (Digital Video) dvbsub raw dvbsub dvbtxt dvbtxt dxa DXA ea Electronic Arts Multimedia ea_cdata Electronic Arts cdata eac3 raw E-AC-3 epaf Ensoniq Paris Audio File exr_pipe piped exr sequence f32be PCM 32-bit floating-point big-endian f32le PCM 32-bit floating-point little-endian f64be PCM 64-bit floating-point big-endian f64le PCM 64-bit floating-point little-endian ffmetadata FFmpeg metadata in text film_cpk Sega FILM / CPK filmstrip Adobe Filmstrip fits Flexible Image Transport System flac raw FLAC flic FLI/FLC/FLX animation flv FLV (Flash Video) frm Megalux Frame fsb FMOD Sample Bank fwse Capcom's MT Framework sound g722 raw G.722 g723_1 G.723.1 g726 raw big-endian G.726 ("left aligned") g726le raw little-endian G.726 ("right aligned") g729 G.729 raw format demuxer gdigrab GDI API Windows frame grabber gdv Gremlin Digital Video gem_pipe piped gem sequence genh GENeric Header gif CompuServe Graphics Interchange Format (GIF) gif_pipe piped gif sequence gsm raw GSM gxf GXF (General eXchange Format) h261 raw H.261 h263 raw H.263 h264 raw H.264 video hca CRI HCA hcom Macintosh HCOM hdr_pipe piped hdr sequence hevc raw HEVC video hls Apple HTTP Live Streaming hnm Cryo HNM v4 ico Microsoft Windows ICO idcin id Cinematic idf iCE Draw File iff IFF (Interchange File Format) ifv IFV CCTV DVR ilbc iLBC storage image2 image2 sequence image2pipe piped image2 sequence imf IMF (Interoperable Master Format) ingenient raw Ingenient MJPEG ipmovie Interplay MVE ipu raw IPU Video ircam Berkeley/IRCAM/CARL Sound Format iss Funcom ISS iv8 IndigoVision 8000 video ivf On2 IVF ivr IVR (Internet Video Recording) j2k_pipe piped j2k sequence jacosub JACOsub subtitle format jpeg_pipe piped jpeg sequence jpegls_pipe piped jpegls sequence jpegxl_pipe piped jpegxl sequence jv Bitmap Brothers JV kux KUX (YouKu) kvag Simon & Schuster Interactive VAG laf LAF (Limitless Audio Format) lavfi Libavfilter virtual input device live_flv live RTMP FLV (Flash Video) lmlm4 raw lmlm4 loas LOAS AudioSyncStream lrc LRC lyrics luodat Video CCTV DAT lvf LVF lxf VR native stream (LXF) m4v raw MPEG-4 video matroska,webm Matroska / WebM mca MCA Audio Format mcc MacCaption mgsts Metal Gear Solid: The Twin Snakes microdvd MicroDVD subtitle format mjpeg raw MJPEG video mjpeg_2000 raw MJPEG 2000 video mlp raw MLP mlv Magic Lantern Video (MLV) mm American Laser Games MM mmf Yamaha SMAF mods MobiClip MODS moflex MobiClip MOFLEX mov,mp4,m4a,3gp,3g2,mj2 QuickTime / MOV mp3 MP2/3 (MPEG audio layer 2/3) mpc Musepack mpc8 Musepack SV8 mpeg MPEG-PS (MPEG-2 Program Stream) mpegts MPEG-TS (MPEG-2 Transport Stream) mpegtsraw raw MPEG-TS (MPEG-2 Transport Stream) mpegvideo raw MPEG video mpjpeg MIME multipart JPEG mpl2 MPL2 subtitles mpsub MPlayer subtitles msf Sony PS3 MSF msnwctcp MSN TCP Webcam stream msp Microsoft Paint (MSP)) mtaf Konami PS2 MTAF mtv MTV mulaw PCM mu-law musx Eurocom MUSX mv Silicon Graphics Movie mvi Motion Pixels MVI mxf MXF (Material eXchange Format) mxg MxPEG clip nc NC camera feed nistsphere NIST SPeech HEader REsources nsp Computerized Speech Lab NSP nsv Nullsoft Streaming Video nut NUT nuv NuppelVideo obu AV1 low overhead OBU ogg Ogg oma Sony OpenMG audio paf Amazing Studio Packed Animation File pam_pipe piped pam sequence pbm_pipe piped pbm sequence pcx_pipe piped pcx sequence pfm_pipe piped pfm sequence pgm_pipe piped pgm sequence pgmyuv_pipe piped pgmyuv sequence pgx_pipe piped pgx sequence phm_pipe piped phm sequence photocd_pipe piped photocd sequence pictor_pipe piped pictor sequence pjs PJS (Phoenix Japanimation Society) subtitles pmp Playstation Portable PMP png_pipe piped png sequence pp_bnk Pro Pinball Series Soundbank ppm_pipe piped ppm sequence psd_pipe piped psd sequence psxstr Sony Playstation STR pva TechnoTrend PVA pvf PVF (Portable Voice Format) qcp QCP qdraw_pipe piped qdraw sequence qoi_pipe piped qoi sequence r3d REDCODE R3D rawvideo raw video realtext RealText subtitle format redspark RedSpark rka RKA (RK Audio) rl2 RL2 rm RealMedia roq id RoQ rpl RPL / ARMovie rsd GameCube RSD rso Lego Mindstorms RSO rtp RTP input rtsp RTSP input s16be PCM signed 16-bit big-endian s16le PCM signed 16-bit little-endian s24be PCM signed 24-bit big-endian s24le PCM signed 24-bit little-endian s32be PCM signed 32-bit big-endian s32le PCM signed 32-bit little-endian s337m SMPTE 337M s8 PCM signed 8-bit sami SAMI subtitle format sap SAP input sbc raw SBC (low-complexity subband codec) sbg SBaGen binaural beats script scc Scenarist Closed Captions scd Square Enix SCD sdns Xbox SDNS sdp SDP sdr2 SDR2 sds MIDI Sample Dump Standard sdx Sample Dump eXchange ser SER (Simple uncompressed video format for astronomical capturing) sga Digital Pictures SGA sgi_pipe piped sgi sequence shn raw Shorten siff Beam Software SIFF simbiosis_imx Simbiosis Interactive IMX sln Asterisk raw pcm smjpeg Loki SDL MJPEG smk Smacker smush LucasArts Smush sol Sierra SOL sox SoX native spdif IEC 61937 (compressed data in S/PDIF) srt SubRip subtitle stl Spruce subtitle format subviewer SubViewer subtitle format subviewer1 SubViewer v1 subtitle format sunrast_pipe piped sunrast sequence sup raw HDMV Presentation Graphic Stream subtitles svag Konami PS2 SVAG svg_pipe piped svg sequence svs Square SVS swf SWF (ShockWave Flash) tak raw TAK tedcaptions TED Talks captions thp THP tiertexseq Tiertex Limited SEQ tiff_pipe piped tiff sequence tmv 8088flex TMV truehd raw TrueHD tta TTA (True Audio) tty Tele-typewriter txd Renderware TeXture Dictionary ty TiVo TY Stream u16be PCM unsigned 16-bit big-endian u16le PCM unsigned 16-bit little-endian u24be PCM unsigned 24-bit big-endian u24le PCM unsigned 24-bit little-endian u32be PCM unsigned 32-bit big-endian u32le PCM unsigned 32-bit little-endian u8 PCM unsigned 8-bit v210 Uncompressed 4:2:2 10-bit v210x Uncompressed 4:2:2 10-bit vag Sony PS2 VAG vbn_pipe piped vbn sequence vc1 raw VC-1 vc1test VC-1 test bitstream vfwcap VfW video capture vidc PCM Archimedes VIDC vividas Vividas VIV vivo Vivo vmd Sierra VMD vobsub VobSub subtitle format voc Creative Voice vpk Sony PS2 VPK vplayer VPlayer subtitles vqf Nippon Telegraph and Telephone Corporation (NTT) TwinVQ w64 Sony Wave64 wady Marble WADY wav WAV / WAVE (Waveform Audio) wavarc Waveform Archiver wc3movie Wing Commander III movie webm_dash_manifest WebM DASH Manifest webp_pipe piped webp sequence webvtt WebVTT subtitle wsaud Westwood Studios audio wsd Wideband Single-bit Data (WSD) wsvqa Westwood Studios VQA wtv Windows Television (WTV) wv WavPack wve Psion 3 audio xa Maxis XA xbin eXtended BINary text (XBIN) xbm_pipe piped xbm sequence xmd Konami XMD xmv Microsoft XMV xpm_pipe piped xpm sequence xvag Sony PS3 XVAG xwd_pipe piped xwd sequence xwma Microsoft xWMA yop Psygnosis YOP yuv4mpegpipe YUV4MPEG pipe ``` # eBooks and Reading in Phyn ## Phyn is designed to be far more than just a video player; it is your comprehensive, all-in-one media haven. By providing native support for a diverse range of digital reading formats and audiobooks, Phyn allows you to transition seamlessly from watching a cinematic blockbuster to catching up on your favorite novel, all within a single, integrated interface. ### Supported Formats Phyn provides exceptional compatibility with the most popular digital publishing and comic book formats, ensuring your library looks and performs flawlessly across all your devices: * **EPUB:** The gold standard for digital books. Phyn utilizes a reflowable text engine, allowing you to enjoy a comfortable reading experience where the text automatically adjusts to fit your screen size and orientation perfectly. * **PDF:** Ideal for documents that require a fixed layout, such as academic textbooks, technical manuals, and high-fidelity art books. Phyn renders these with crisp detail, preserving the original formatting of every page. * **CBR & CBZ:** Dedicated support for comic book archives. Whether you are reading a vintage graphic novel or the latest manga, Phyn ensures that high-resolution imagery loads quickly and looks stunning, handling sequential art with the specialized care it deserves. * **Audiobooks:** High-quality, native playback for your entire spoken-word library, turning Phyn into a powerful companion for your daily commute or evening relaxation. ### Getting Started with eBooks To access your reading material, your **Jellyfin Server** must have a library of the "Books" type properly configured. Once your files are populated on the server, Phyn will automatically discover and organize them for you. 1. **Open the Phyn App:** Navigate to your Books library from the main home screen. 2. **Select a Title:** Tap on any book to view its rich metadata. Here, you can read detailed descriptions, view author information, and see cover art fetched directly from your server. 3. **Start Reading:** Simply tap the **Read** button to launch the built-in viewer. Because Phyn uses a native engine, the transition is instantaneous and fluid. #### Reading Features * **Native Viewer Integration:** Phyn eliminates the need for clunky third-party reading apps. By opening files directly within the app, we maintain a consistent, high-performance experience that doesn't drain your battery or clutter your device with extra software. * **Intelligent Progress Syncing:** Phyn constantly communicates with your Jellyfin server to keep your place. If you start a chapter on your iPhone during your lunch break, you can open Phyn on your Mac at home and resume exactly where you left off without missing a beat. * **Enhanced Table of Contents:** For EPUB and PDF files, Phyn provides an intuitive sidebar navigation menu. This allows you to jump between chapters, sections, or specific bookmarks with a single tap, making it easy to navigate even the longest technical documents. ### Audiobooks Phyn provides a rich audiobook experience that is second to none, integrating seamlessly with your device’s native media center and notification tray. * **Background Playback & OS Integration:** Phyn supports full background media playback. You can control your book; pause, play, or skip, directly from your lock screen or notification center, just like your favorite music app. * **Granular Playback Speed:** Tailor the narration to your preference. Use the built-in controls to adjust the playback speed (e.g., 0.5x to 2.0x), allowing you to breeze through familiar content or slow down for complex narrations. ### Troubleshooting & Tips #### Table of Contents & Navigation If you find the Table of Contents is unresponsive or page-skipping feels inconsistent, please verify your file's formatting. While Phyn supports a wide range of versions, older or "scanned" PDF files may lack the internal metadata required for chapter navigation. For the best experience, we recommend using modern EPUB files. #### Paywall & Subscription Clarification Phyn is free to download and allows for basic library browsing and media playback. However, advanced "quality-of-life" features, such as **Resume Playback** (automatically returning to your last page after the app has been closed), may require a **Phyn Premium** subscription. These contributions directly fund the development of our specialized native players for iOS, Android, and macOS. #### Connection & Visibility If your books aren't appearing in your library, first verify that your Jellyfin server is reachable. Then, ensure that the specific "Books" library on your server has been shared with your user account. If the library is visible on the Jellyfin Web UI but not in Phyn, try refreshing your home screen within the app to trigger a re-sync. **Need more help?** If you encounter a specific file that won't open or a bug within the reader, please reach out to our team at . When emailing, please include your device model, the OS version, and the specific file extension (e.g., .epub or .cbz) you are having trouble with. # Using the Release Calendar 📅 ## The **Release Calendar** in Phyn serves as your personalized mission control for tracking upcoming episodes, season premieres, and new cinematic releases for the shows you follow most closely. By moving away from a static library view, the calendar provides a dynamic, high-level overview of your media schedule, ensuring you are always informed about what is dropping next in your entertainment universe. ### How it Works: The Trakt Integration 🔗 Unlike the standard library views in Phyn that pull data directly from your Jellyfin server, the Release Calendar is powered exclusively through a deep integration with your **Trakt.tv** account. This means the calendar doesn't just look at what you already have stored locally; it looks forward at the global broadcast schedule for the content you care about. To populate your calendar and start tracking, you must link your account following these steps: 1. **Create an Account:** Visit [Trakt.tv](https://trakt.tv/) and sign up for a free account if you don't already have one. This account acts as the master database for your viewing habits. 2. **Curate Your Watchlist:** Use the Trakt website or mobile app to search for shows and add them to your **Watchlist** or **Collection**. These are the specific titles Phyn will monitor for upcoming air dates. 3. **Link to Phyn:** Within the Phyn app, navigate to **Settings** > **Integrations** and select the **Connect Trakt** option. You will be prompted to authorize Phyn to access your Trakt data. Once successfully linked, Phyn performs an initial sync to pull your tracked shows and immediately begins plotting their upcoming air dates across your personal calendar view. 🔄 ### Accessing the Calendar The Release Calendar is integrated directly into the core navigation of the Phyn interface for quick access: * **Side Drawer Menu:** Simply swipe from the left or tap the menu icon to open the side navigation drawer and select **Calendar**. This provides the full-screen monthly experience. * **Homescreen "Coming Soon" Row:** For a glanceable update, the "Coming Soon" row on your main dashboard offers a snapshot of what is airing **today** and **tomorrow**, acting as a quick-reference guide for your immediate viewing plans. ### Key Features #### Detailed Monthly Schedule 🗓️ The calendar offers a clean, intuitive monthly layout that helps you visualize your viewing month at a glance. It distinguishes between past airings and upcoming releases, highlighting exactly what is premiering **today**, **tomorrow**, and through the end of the month. This ensures you can plan your binge-watching sessions around the actual broadcast schedule of your favorite series. #### Personalized Watchlist Syncing The calendar is entirely reflective of your personal tastes. If a highly anticipated new show is missing from your Phyn calendar, you don't need to change any settings in the app, simply add that show to your **Watchlist** on Trakt. Phyn will detect this change during its next background sync and update your schedule to include the new premiere dates automatically. ✨ #### External Notification Management 🔔 It is important to note that the Release Calendar is a visual scheduling tool and does not generate automated alerts on its own. To ensure you never miss a moment, you must configure your **Notifications** separately. By visiting the **Settings** menu, you can toggle specific alerts that will notify you the moment a tracked episode becomes available and ready to stream on your server. ### Troubleshooting #### "The calendar is empty or out of date" * **Verify Trakt Connection:** Double-check that your account is still successfully authenticated under **Settings** > **Integrations**. Sometimes re-authorizing the link can resolve syncing stalls. * **Audit Your Watchlist:** The calendar only shows shows you have actively "Watchlisted" or added to your "Collection" on Trakt. Verify these titles are present on the Trakt website first. 🧐 * **Sync Latency:** Depending on your network, it may take a few moments for new Trakt additions to appear in Phyn. Try closing and restarting the app to force a fresh data pull. #### "I see the show on the calendar, but can't play it" The Release Calendar tracks the **global airing date** (when the episode broadcasts on its original network). If a show appears on your calendar but the "Play" button is unavailable, it simply means the content has aired but the file has not yet been added to your personal Jellyfin server. The calendar acts as your schedule, while your library handles the actual files. **Have suggestions for the Calendar?** We are constantly refining the layout to make your schedule even more readable and beautiful. If you have feedback on the interface or ideas for new tracking features, we’d love to hear from you at . 📧 # Jellyseerr Integration Guide 🔗 Enhancing User Experience with Jellyseerr Requests The need for seamless integration of services to create a holistic media consumption experience is a need not a want. Phyn has taken the giant leap forward by integrating [Jellyseerr](https://github.com/Fallenbagel/jellyseerr), a robust request management tool for your media library. This integration empowers users to connect their Jellyseerr instance directly within the app, enabling them to request movies or TV shows effortlessly. {% hint style="info" %} You need a [Jellyseerr](https://github.com/Fallenbagel/jellyseerr) instance/server to use this integration successfully. Reach out to your server administrator to get started. {% endhint %} ### **What is Jellyseerr?** Jellyseerr is an open-source tool designed to streamline the request process for new content on various media servers, including Jellyfin. It acts as a bridge between users and the media server administrators, allowing for an organised and efficient way to handle content requests. ### **Benefits of Jellyseerr Integration on Phyn** * **User Empowerment:** Users can directly request new titles without the need to contact the server administrator or even leaving the app. * **Efficiency:** The integration reduces the time taken for requests to be processed and added to the Jellyfin library. * **Centralized Requests:** Keeps track of all requests in one place, avoiding duplication and making management easier. * **Transparency:** Users can see the status of their requests, whether they're pending, approved, or declined. ### **How to Use Jellyseerr in Phyn** 1. **Connect Your Jellyseerr Instance:** * Navigate to the app settings. * Toggle the Jellyseerr switch to turn it on * Fill your Jellyseerr credentials and save * Once connected, the app syncs with your Jellyseerr account. 2. **Making a Request:** * Browse through the app's interface for movies and TV shows. * When you find a title not available in your library, tap the 'Request' button. * Your request will be sent directly to Jellyseerr for processing. 3. **Tracking Your Requests:** * Go to the 'Requests' section within the app to view the status of all your requests. * You'll receive notifications when your requests are approved or available to watch. 4. **Enjoying Your Content:** * Once a request is fulfilled, it will appear in your Jellyfin library. * Sit back, relax, and enjoy your newly added movies and TV shows. # Trakt Integration Guide 🔗