Z-Keeper.com - Master your Zidoo media library

Discussion in 'General Development' started by Chris Pierce, Jul 2, 2026.

  1. Chris Pierce

    Chris Pierce Member

    I will provide more answers to you when I can (I’m away on vacation), but in short, your current Zidoo DB is in no risk of being damaged by Z-Keeper. It makes the same calls to the Zidoo that its web UI uses, plus more functionality that the web UI does not provide. You can feel confident it won’t damage the significant effort you have put into arranging your library.
     
    Akhnaten likes this.
  2. Akhnaten

    Akhnaten Active Member

    Thank you for your reply !
    It is already helpful, although I will be happy to have more details when you return.

    Have a wonderful holiday !
     
  3. Netmask

    Netmask Well-Known Member

    You can create , edit and add multiple genre using TMM on your PC or MAC followed by a refresh metadata on the Zidoo. Use to drive me mad when I first got my Zidoo. You should be able to do it on the web editor.
     
  4. Markswift2003

    Markswift2003 Well-Known Member SUPER Administrator Zidoo Beta Tester Contributor

    The web UI has always been... er... interesting... It never seemed to get fixed in any of its iterations - I gave up asking years ago...

    I never really got along with TMM, but Z-Keeper is evolving into a very impressive bit of kit...
     
  5. Cary Grant

    Cary Grant Member

    I have signed up for the beta. This is amazing work. Zidoo surely should donate a player to Chris for this program
     
    Юрий Гандев likes this.
  6. Chris Pierce

    Chris Pierce Member

    Thanks Cary.
    I ponied up and just bought a Z9X 8k. I needed to get the multi-Zidoo device logic working and there were no offers from the beta group (understandable). Plus - what a good excuse to upgrade my Z9X Pro.
    Perhaps there's a future where I can help the Zidoo team with their efforts on the HT app. As a user, I am pretty motivated, and as a programmer, maybe I have something to offer them that they feel would be of benefit.
     
    Юрий Гандев likes this.
  7. Chris Pierce

    Chris Pierce Member

    Beta 7 does this quite well thanks to a new method that our contact at Zidoo told me about (undocumented). Set your poster and backdrop to any image you like off your PC.
    I will have to dig into the API documentation and see if I can find a way to create new genres. Z-Zeeper already lets you assign the predefined genres to your movies just like the web UI does. If I can figure out how to create custom genres, I will add that feature too. I must admin, with all the genres the Zidoo already has, I didn't expect this would be something users would want. Would you mind sharing an example of a custom genre for me - like "Home movies" or something like that?
    Wow! You have put quite a lot of time and effort into managing your movie library! I'm far too lazy to put in that kind of time into customizing my posters and genres. While the list of genres assigned to movies in the Zidoo (likely from TMDB, actually) is really awful (eg. it calls a lot of movies "Comedy" that are so far from it!), I find the default posters are usually pretty good (although lately I don't like the ones it's going with - but again, this is a TMDB thing now that I've spent time interfacing with the TMDB interface - we pick the top choice of poster and backdrop art which should be the official one, but too often now it's a fan-created thing that looks wrong for the movie.
    Z-Keeper's design is non-invasive. It keeps its own database on your PC that mimics the one in the Zidoo. You can change things in the Zidoo database, like poster art, genres, collection grouping, categories, etc., but you are doing this intentionally. Z-Keeper won't damage anything in your finely-crafted movie catalog. The only way Z-Keeper can make changes to the Zidoo database is through the API interface it supports (primarily for the web UI, as far as I know), so it's safe.
    The #1 goal of Z-Keeper is to help you find problems in your collection and fix them. Yes, you can edit it as well, like the custom posters, but my main purpose for building this (for myself) was to help me manage all the bad matches the Zidoo would do, and the video files the Zidoo simply refused to acknowledge even existed. I know TMM is a commonly used tool that can do a lot, but it doesn't interface with the Zidoo and the user interface and I just didn't have an understanding. I love designing fun and attractive UI's so if I can get all the functionality TMM has, and also have it talk directly with the Zidoo, look good, and have many features TMM doesn't do, then I think it's a fun project to be a part of.
    So "sophisticated" to you may be par-for-course for others. I want it to be easy to use, but still powerful at batch processing many titles at once and capable of more advanced tools, such as the shared catalog comparison tool (doesn't share actual videos, but the runtimes of videos to help us check that our titles are correct - especially episodes of TV series which can be tricky to rip in the right order).
    While I have more folder structure than you do, I personally want to stay away from NFO files if possible. It's just one more "sidecar" file to have to maintain. But people like @Markswift2003 like the NFO approach as it gives a lot of control to ensure the Zidoo does what Mark wants it to do. It doesn't work for Favorites and Watched and some other metadata that the Zidoo database supports because the Kodi NFO standard doesn't have those tags.
    Zidoo keeps it's own DB. While Z-Keeper has a more robust DB to do what it does, it's only there to help you maintain the Zidoo DB, so the Zidoo doesn't know Z-Keeper exists, so stop using Z-Keeper and the Zidoo is none the wiser. No risk to your Zidoo or any dependency on Z-Keeper.
    Oddly, I have never had a corrupted Zidoo DB in my many years owning them. It's pretty stable, though the newer HT versions have many issues that resulted in my building this software. And all the manipulation I've done to my Zidoo using Z-Keeper, nothing bad has happened and it's been quite stable.
    I hope this helps answer your ponderings.

    - Chris
     
  8. Cary Grant

    Cary Grant Member

    Now only if Zkeeper could parse multi episode TV files, for example; NameS01E01S01E02... and correct what is my main bugbear of HTx this inability. Dune's My Collection is actually capable of this.

    Zkeeper at present does not parse these TV titles automatically.
    Note that you can define multi episodes in at least two ways such as "ProgramName SxxE01SxxE02SxxE03.." or "ProgramName SxxE01E02E02.."

    McBluna's Zidoo db program did mange this very nicely but it had no front-end/GUI to speak of, so was awkward to use. But still it worked very well indeed.
     
  9. Chris Pierce

    Chris Pierce Member

    Interesting…
    I was not aware the Zidoo was capable of multi-episode records. I will give this a try and if I find it can, I can definitely update the filename parser to understand that syntax.
    Thanks for the suggestion.
     
  10. Markswift2003

    Markswift2003 Well-Known Member SUPER Administrator Zidoo Beta Tester Contributor

    I don't think multi episode mkvs are supported in the API - not sure what TMM does - maybe just treat a multi episode mkv as a single episode?
     
  11. Chris Pierce

    Chris Pierce Member

    From my research, the Zidoo doesn't support multi-episode video files. However, the Kodi standard does. Since Z-Keeper is now (beta 8) able to manage your movie library outside of a Zidoo, I have updated it to support the official Kodi filename convention for multi-episodes. This allows Z-Keeper to create NFO files that indicate the multi episodes. When talking with the Zidoo, however, it will only reference the first episode of a range. I will reach out to our contact at Zidoo to see if I'm missing something.
     
  12. Netmask

    Netmask Well-Known Member

    If tmm supports, I doubt it, I’ve never been able to get it to work, I’ve tried all the rename options. I end up splitting the eps with Avidemux or in one case renamed to Ep1 and created a Ep2 dummy file to get the synopsis in HT and adding to the Synopsis READ ONLY.
     
  13. Netmask

    Netmask Well-Known Member

    Via AI
    TinyMediaManager (TMM) handles multi-episode files automatically by parsing filenames during a data source update, but offers limited output formatting choices and no manual creation option. [1, 2, 3]

    How Multi-Episode Detection Works
    • Initial Detection: TMM reads consecutive numbers or patterns in your original file name (e.g., S01E01E02) when you first scan or update the data source. [1]
    • Linking Files: A single media file must be mapped and linked to multiple individual episodes within TMM's internal database. [1]
    • Manual Limitation: You cannot manually flag a single file as a multi-episode entity inside TMM if it fails initial automatic detection; it relies entirely on filename parsing. [1, 2]

    Renaming Behavior & Styles
    • Default Output: TMM's renamer typically outputs multi-episode files using a spaced format like ShowName S01E01 S01E02 rather than continuous hyphenated blocks (like S01E01-E02). [1, 2, 3, 4]
    • Settings: You can check or adjust basic options under the TV Show Renamer Documentation to see available multi-episode naming style choices. [1]
    • Fixed Grouping: TMM groups all season/episode numbers together based on internal patterns, which some users find rigid if they prefer alternative media center (like Plex or Emby) naming conventions.
     
  14. Chris Pierce

    Chris Pierce Member

    This is my parser's rules for multi-episode files (after the series name):
    • .S01E01S01E02S01E03
    • .S01E01E02E03
    • .S01E01-E04
    • .S01E01-02-03
    • .S01E01S01E02
    and dot/space-separated variants.
    My personal preference is to keep each episode one file, but I have also ripped multiple episodes into a single file when there was just too many to rip (lazy), and I've just dealt with the Zidoo thinking it was just a long single episode.
     
    Netmask likes this.
  15. Cary Grant

    Cary Grant Member

    I used tmm and now Media companion both do multi-episode files. As I stated in a previous post McBluna's program dealt with multi-episode files and transferred then successfully to HTx. It's the HT parser which does not like multi episode structures but once in the database HT reads them back fine. Obviously for example if the file is Program S01E01S01E02S01E03.xx and you select episode 2 or 3 HT will play from the start of the file and also set the watched tag for the whole file. However the database shows the plot description for each episode correctly. so It parses the multi episode nfo correctly. I can post or dm a sample nfo file if required
     
  16. theory

    theory Active Member

    I just noticed this thread for the first time. Does this app have any functionality that would help keep watched/unwatched items in sync between several Zidoo boxes? I appreciate that Trakt was added to HT, but support has been lacking
     

Share This Page