Catchup settings

Perfect Player IPTV app (v1.4.3b5 and higher) supports such catchup tags:

  • catchup – catchup type
  • catchup-source – URL or a part of URL used to generate archive URL
  • catchup-days – the number of archived days on the server (default is not limited)

Catchup types:

  • defaultcatchup-source tag completely describes archive URL
  • appendcatchup-source tag value will be added at the end of channel URL to get  archive URL
  • xc – ‘Xtream-Codes’ server (catchup-source can be used to manually set additional time shift in hours)
  • ez-ts – ‘Ezserver’ time-shift (catchup-source must contain DVR buffer size in minutes; catchup-days tag is ignored)

Catchup source variables:

  • ${start} – archive start time in Unix Timestamp Format
  • ${timestamp} – current time in Unix Timestamp Format


Catchup tags can be specified in playlist URL:|catchup="append" catchup-source="?timeshift=${start}&timenow=${timestamp}" catchup-days="5"|catchup=xc|catchup=ez-ts catchup-source=240

in playlist header:

#EXTM3U catchup="append" catchup-source="?utc=${start}&lutc=${timestamp}"

and for each individual channel in playlist:

#EXTINF:0 catchup="default" catchup-source="${start}&lutc=${timestamp}" catchup-days=3,Channel1

Obviously, new catchup types will be added in the next app releases.

If you can provide us with a temporary server account with a new catchup type, this will be used to test and implement it in the next updates. Thanks for support!

This entry was posted in Info. Bookmark the permalink.

66 Responses to Catchup settings

  1. Xhoan Lee says:

    nichmann I have been waiting for the catchup for a while sofar and I can provide you access to my server and the necessary urls that xtream-codes use. I have written you loads of time: Just drop me a message if you are interested or reply to my emails that I sent you

  2. david234 says:

    i am want your work playlist please sent to

  3. Will says:

    Hey nikman. First impressions of catch up are positive .
    One thing I’d like to recommend is to add a symbol(or signifier) to channels which have catch up . It is never the case that all channels have catch up in iptv . This will let the user know a channel has the ability or not .

    Awesome work man

    • marco92200 says:

      do what i do. lock the channel. it gives the symbol you’re looking for and it still plays it. i dont know what locking the channel does yet but ill come back to you once i find out

  4. DJSanyok says:

    Excellent! All works perfect 🙂

  5. Arunah says:

    What do I need to add to catchup=xc to increase number of days to catchup? TIA

    • nikman says:

      If you don’t pass catchup-days tag, then the number of days will be only limited by EPG data.
      I.e. the number of days for past programs that are stored in the EPG.

      • Arunah says:

        Hi Nikman, sorry I don’t understand. Could you please explain some more. Thanks

        • nikman says:

          You can download your EPG and see in a text editor the date range of programs data.

          • David Hulme says:

            Sorry so what do we do to extend catchup to 7 days |catchup=catchup-days”7”

  6. Awesome update. Makes this app the best on the market for IPTV now hands down. Would love to see a symbol besides the channels with catchup, and to be able to access the archive box from full screen play (via the small quick settings floating toolbar that pops up)

  7. bsmajgel says:

    Hi, i have bought Perfect player on Amazon and i have still unlock full version, can you help me? Can you make give one funktion Video calibration like Kodi has. Thnx

    • nikman says:

      If you have issues with Full version activation, try to restart device/app. Start Amazon appstore app just before Perfect Player after reboot.

      I was told Fire TV devices has internal video calibration feature for all apps.

  8. Dave1 says:

    Hi, do you have basic instructions on how to set up catch up tv in PP for my IPTV provider, Ace tv?


  9. James says:

    Is there anyway to extend number of catchup days for XC catchup types from existing 24hrs?

  10. Clive Browne says:

    can you use catchup if you filter your url via xtream?

  11. bdguth07 says:

    How would I do a timeshift of 1 hour for the XC catchup type? I have an issue where when I go to play the archive, that I have to fast forward for 60 minutes to get to the program that I want to catch up on. Any ideas? Thanks!

  12. Will says:

    A popular iOs app also had their catchup restricted to epg data on xtream-codes . Recently they switched “will load directly from api” thus making catchup for the whole 7 days instead of 1 . Would you be able to implement this?

  13. AL says:

    How can I fast forward or rewind watching a program on catchup? Can I use a regular remote control if so, please let me know how.

    Thank you for your great work.

    • nikman says:

      You can use “Left”/”Right”/”RW”/”FF” keys for seeking and “Up”/”Down” keys for larger seeking.

      • AL says:

        Thank you.

        I noticed quite a big audio lag while I was watching soccer on catchup.
        Is that something that can be fixed?

        I recall that kodi has a feature that you can adjust the audio lag. Could something like this applied to perfect player? Just a thought.

        Thanks again.

        • nikman says:

          1. You can try to select different decoder
          2. With Hardware and Software decoder you can set “Audio shift” in video options

          • AL says:

            Appreciate the quick response.

            FYI: I also noticed that the lagging was due to the internet connection. For some reason the connection was fluctuating. I reset the router and everything went back to normal.

            In my previous question regarding the remote control, I assume the remote control has to be on the same wireless network for it to work with the perfect player which is installed on my android box? Am I correct?

          • nikman says:

            Yes. Perfect Remote and Perfect Player IPTV apps must work in the same network to communicate.

          • nikman says:

            However, you can try Perfect Remote v1.1.1a1.
            You can set player’s IP-address manually – so, this should work even if apps are in different networks.

  14. Steve says:

    I have the archive section and when I click on a channel I can see the catch up programmes. But when I click on one of the programs they won’t play. Is there something else I need to do. I have the free version. Thank you very much.

  15. Brian W says:

    Is catchup available on the Windows version of Perfect Player or is it only on Android?

  16. marco92200 says:

    Quick question when I try to do the catchup in kodi with vader streams it works perfect but when I try I do the backup within perfect player it’s glitchy and stutters every second while audio is repeating

  17. Mark says:

    Hi Do I have an earlier version of Perfect Player do I have to unl.oad
    it to instal a newer version??

  18. Steve says:

    Nikman can you give me laments terms how to make 14 days catchup appear? I just can not figure it out from the above.

  19. How do you exit the software when running in fullscreen mode?

  20. Will says:

    Would you be willing to work on fixing the catchup issue for Fab IPTV? Currently we only get 24 hours catchup but using other apps Fab users get 2-7 days depending on the channel. I read in their forums that an admin said if Perfect Player is reading from the epg URL, it’ll be limited. That’s because a separate URL in a different API is required for more than 24 hours and the API for that for Fab is public.

    • Will says:

      Any thoughts on this @nikman? Would be great for so many users especially those of us that bought the full version. Thanks!

      • nikman says:

        Did they provide you with any documentation?

        We know the issue and it’s in our plans to improve.

        • Will says:

          They didn’t provide documentation but sounded like they are very willing to help if needed. I know they said the API that had the info was publicly available. If there’s anything I can do please let me know. Thanks!

  21. Darko says:

    I add in M3U list “#EXTM3U catchup=xc ………..” for a channel that has the ability catchup and it works.
    Can it be added icons to the status line for the channel that have catchup ?

  22. Naz says:

    dear Sir/ madam Can you advice me from where I can download a free EPG for perfect player on an android tv box? Thank you Naz.

Leave a Reply