On this page
Checkrr: Problems
Find what is wrong with Checkrr, then follow the numbered answer.
The chart in words
Start: Checkrr is not working as it should
- Then: What does its tab say?
- Did not start: 1. Start it again
- Not supported: 2. Update it or update Starboard
- Active, but something is wrong: What is wrong?
- The card lists bad files: 3. Replace a bad file
- It has not checked yet: 4. Start a check
- A file I know is damaged passed: 5. Know what it checks
- Its page does not open: 6. Open its page
1 Start it again
Its tab says Did not start when Checkrr did not start, or stopped answering.
- On Checkrr's tab, read the message under its state: it says why it stopped.
- Select Try again.
- If it stopped soon after an update, select Roll back to and the version you had. Read Updates.
- If you changed its settings file,
checkrr.yaml, a mistake there stops it starting. Undo your change, or move the file out of its folder so Starboard writes a new one at the next start. - Still failing: go to System, then Logs, and find its name.
If the card says No answer from and its name, it did not answer in 3 seconds. Check that it is Active on its tab, then wait a minute.
2 Update it or update Starboard
Your Starboard's plug-in API is outside what this version of Checkrr works with, so Starboard stopped it.
- Select Check for an update on its tab.
- If there is none, update Starboard. Read Update Starboard.
3 Replace a bad file
Checkrr changed nothing: the file is where it was. Replace it yourself.
- On Checkrr's tab, open Files that failed the check. Each row has the file, its folder and Checkrr's reason.
- Play the file in Jellyfin to check it is damaged. "not recognized" means its start is not a film or episode Checkrr knows.
- In Reelix, search for the film or episode again and choose a new copy. When Reelix brings the new one in, it replaces the old file: it moves the old one to Reelix's recycle bin when Recycle bin folder is set in Reelix's settings, and otherwise deletes it for good. Set the recycle bin first to keep the old file.
- Select Check now on Checkrr's tab. A replaced file drops off the list once it passes.
To take a damaged film out of the library without deleting it, the Library clean-up plug-in moves it to the holding folder.
4 Start a check
The card says "Not checked yet" until the first Sunday night after you add it.
- On Checkrr's tab, select Check now and confirm.
- The card's status changes to Scanning. A large library takes hours the first time.
5 Know what it checks
Checkrr reads the start of each file and asks FFprobe to read it. That finds files whose start is damaged, files that are not media at all and videos with no sound. A file cut short part way through can pass. Read Settings.
6 Open its page
Checkrr's page is on your home network, at this computer's address and the port Starboard chose for it. The port is not always 8585: Starboard takes the next free port when that one is in use.
- Check Checkrr's tab says Active. Starboard gives it a port only once it is active.
- Under Its web page, read the address, then select Open Checkrr.
- Open it from a device on your home network. It does not open from away from home.
Report a problem
If none of these helps, tell its maker, with what its tab and the card say: the plug-ins' issues on GitHub.
Find out more
This page on GitHub, where the help is written.