This wiki contains Frequently Asked Questions about DuckieTV features, settings, common problems, etc.
Can DuckieTV search for Anime torrents?
Can I help DuckieTV with Language Translations?
Can I run DuckieTV Standalone on ARMv7?
Can I run DuckieTV Standalone on osX ARM64?
How can I get the DuckieTV app?
How can I make corrections to shows on DuckieTV?
How can I make the fonts larger or smaller?
How does DuckieTV interact with TraktTV?
How do I authorise DuckieTV to sync to TraktTV?
How do I get DuckieTV to use the torrent scene's naming or dated scheme for a series' episodes?
How do I raise a Bug Report?
How do I set the download path for a series?
How do I set the quality for an individual series?
How do I stop the Auto-Download from downloading fakes?
How to connect with a Deluge Seedbox?
How to connect with a ruTorrent Seedbox?
How to connect with a Transmission Seedbox?
How to install development versions of DuckieTV?
How to use Jackett with DuckieTV?
How to set up Auto-Download?
How to set up Torrent Clients?
I can't add a series and there is nothing in the calendar?
I can't connect the DuckieTV torrent client using localhost in the address field?
I have set up a Series Download path but it is no longer working
I run Dtv 24/7. How do I stop Dtv from maximising its window?
Where does DuckieTV keep its local database?
Why can't DuckieTV automatically put shows in correct folders once downloaded?
Why does the Tray not work on Ubuntu?
Why does Standalone Dtv not work on Ubuntu21+ or Lubuntu21+?
Why is Auto-Download not downloading anything?
Why is the Episode Find a Torrent button not working?
To allow DuckieTV to sync to Trakt.TV you first need to authorise DuckieTV to use your Trakt.TV account.
- navigate to the TraktTV settings panel and click on the Authorise button
- which should start a Trakt.TV login page on your system's default web Browser, so enter your Trakt.TV account username and password and click on the Sign In button
- once you complete the Trakt.TV login, the Trakt.TV web site should present you with a PIN popup.
select the PIN and copy it to your clipboard
-
paste you PIN in the Trakt.TV PIN box and click on the login to Trakt.TV button.
- you are now authorised.
If for some reason you are not redirected to your browser for login to Trakt.TV, or if after login you are not presented with a PIN popup, then try using https://trakt.tv/pin/948 on your browser directly instead.
If it does not present the PIN popup then check your browser content settings for popup and redirect blocking settings that prevent popups, or if you are using an AD Blocker extensions then set an exception for Trakt.tv.
Return to Index
First a little background. As you may know, DuckieTV gets all its data from the Trakt.TV service, which in turn aggregates data from TMDB. See this wiki for a more detailed description.
DuckieTV then can use this data to help you search for episode torrents, using the standard SeriesName SxxExx naming scheme.
But unlike the regular TV torrent scene, where the major scene groups got together and agreed on a common naming scheme for episode torrents, the Anime scene is, to put it bluntly, a dog's breakfast of different naming methods.
So there is no fool proof way to automatically find any and all Anime torrent episodes, and DuckieTV is not a TV show calendar app that specialises on tracking Anime.
However, DuckieTV should be able to search and find the latest Anime episode torrents.
For other Anime that are problematic, the hiccup is usually resolved by switching to an alias that the Anime torrent scene might be using, instead of the title of the broadcast as listed in the TVDB.
DuckieTV makes use of theXem.info, which provides an alias mapping service for series that have torrent aliases. If your Anime series has an alias that DuckieTV is aware of, you can select it from the DuckieTV Series Settings Dialogue, which you can access from a multitude of places, where ever DuckieTV presents details for a series or episode. Look for the cog icon.
If you know of an Alias in use on the Anime torrent scene that is not showing up on the DuckieTV alias list, consider joining #xem on irc.freenode.net and asking the team to add it for you. DuckieTV keeps up to date by refreshing it's Alias list daily from theXem.info .
The most commonly used episode numbering scheme in the Anime torrent world is the use of an absolute number. This counts episodes sequentially, regardless of season releases.
So for any series that Trakt.TV has flagged as Anime, DuckieTV will use the absolute episode number in its torrent searches. However if an absolute number is not available for an episode, DuckieTV will default to the regular SxxExx season/episode scheme as provided by Trakt.TV.
If the Anime series does not fit this criteria then you will have to manually search for your episode torrents using the DuckieTV torrent search dialogue.
Sometimes the series' title is not identical to the one that the torrent scene use for that series' episodes.
For example, the most popular torrents for the 2017 British TV series Taboo are currently labelled Taboo UK by the torrent scene, to distinguish them from torrents of the unrelated USA 2002 Taboo TV series.
Another point of difference is when a series' episode numbering is different from the ones used by the torrent scene. For example, episode The Daily Show - s22e67 will only have torrents labelled The Daily Show 2017 02 16 available.
DuckieTV uses a SceneNameExceptions table that selects the torrent naming scheme used during its torrent searches.
So if you find that DuckieTV is not using the most popular torrent names for a series, or it's using the s00e00 episode numbering scheme when its torrents are using a dated scheme, then simply post a request on Reddit.
In your request, specify the full name of the series, and the alternate title you want DuckieTV to use in it's torrent searches.
We will update our SceneNameExceptions table, and within 24 hours, your DuckieTV app will fetch the updated table and begin using the new scheme.
Dtv was not designed to be a Trakt.tv app (like some of the other iphone/android phone apps out there).
Dtv came first, and the Trakt.tv interface was added later, for use in setting up Dtv during installation.
So the Dtv - Trakt.tv interaction is not a true two-way sync.
Dtv does not need to have a Trakt.tv account to work. You add shows using the Dtv add-a-ahow, and Dtv fetched updates of the show details and episodes from the Trakt.tv API servers.
If you have set up a Trakt.tv account (a/c) and set up Dtv to connect to it, then it is used by Dtv in the following ways:
-
During a Dtv import (when you are starting Dtv up the first time, or resetting after a wipe), you can fetch all the series, and the episode states (collected, watched) from your Trakt.tv a/c instead of using a Dtv backup import. This is the only time that Dtv fetches anything from your Trakt.tv a/c.
-
Whenever you change the state of an episode on Dtv (downloaded, watched), it sends that update to your Trakt.tv a/c as a History record. The point of the update is to facilitate subsequent imports as first described in item (1).
-
If you add a new series via the Dtv add-a-show, that show also gets sent to your Trakt.tv a/c as a Collection record.
For Torrent Clients that support this (currently BiglyBT, Deluge, qBittorrent 3.3.1 (and newer), rTorrent, Transmission, Vuze), you can set the series Download Path by visiting that series' details side panel, clicking on its settings button, which will bring up a popup.
Note: DuckieTV will not display the download path setting if it is not actively connected to the torrent client.
- For DuckieTV Standalone with local torrent hosts:
At the bottom you will find the Torrent Download Path section. Click on the Choose File button and select a folder path. Click OK then Save.
To remove a previously saved Download Path setting use the Clear button then Save. - For DuckieTV Standalone with remote torrent hosts, and for DuckieTV on Chrome Browser:
At the bottom you will find the Torrent Download Path section. Enter the full download path in the box provided. There is no validation, so make sure the path is valid for the platform you are targeting.
To remove a previously saved Download Path setting just clear the box and save.
Note You must ensure that the folders in the path have been created or it is likely that the torrent client will not use that path and select its default path instead.
- if using qBitTorrent, set the Default Torrent Management Mode to manual otherwise it will continue to use its default download path.
- Make sure that the Torrent Parameters setting is disabled. Otherwise your download paths will not be used.
If you want to set a particular series to some other quality than the default preferred quality, say 1080p instead of 720p for example, you can do this using the series settings panel.
- navigate to the series in question and click on the settings button
- or
- and load your preferred series quality for this show in the custom search string box,
- turn on the check box for do not use the preferred quality for this show,
- and then click save.
Unfortunately DuckieTV cannot examine the content of the torrents to determine what files are within.
The only parameters that are fetched by the search engines are the torrent name, seeders and leeches count, file size, and the magnet/torrent and details links. These are the details that are available on most torrent sites from the general search-results page.
If you are using the auto download to fetch torrents, then there are several ways you can try to minimise the chances of downloading a fake.
- Bump your seeders threshold higher. Fakes don't usually have a high seeders count.
- Add an hour or more to the delay time, so you give the torrent web site moderators time to remove the fakes.
- Add include keywords for the release groups that are reliable, they tag their group to their torrent names.
- Add ignore keywords for torrent names whose tags almost always provide fakes.
- Use a search engine that posts verified torrents only, such as RARBG for instance.
Read this wiki page to familiarise yourself with the basics, and you will find that in most cases all you need to do is enter the address you use to access your Deluge SeedBox in the Address field in DuckieTV's Deluge Integration panel, along with the Password.
If you currently use the ruTorrent WEBUI from your Chrome Browser to manage your torrents on your rTorrent Seedbox, you can probably connect DuckieTV to it as well.
Begin by reading this wiki page to familiarise yourself with the basics (ignore the pre-requisites section).
But before actually making set-up changes on DuckieTV's rTorrent Integration panel, you are going to need to find out what base path to use.
This will depend on what your Seedbox provider is using, and if they do not explicitly say so in their help documentation, then you can find out by using your Chrome Browser's Development Tools.
So on your chrome browser, having connected to your rTorrent server via the ruTorrent WEB UI, press the F12 key to open the browser's Development Tools page, and click on the Network tab.
You should see activity as the ruTorrent WEB UI polls the rTorrent server for updates.
Click on one of the entries and take a look at the header. you should see the full path used to access the rTorrent command.
This picture should help give you the general idea
So if for example, you are using a Seedbox from online.net, you might see something like: http://sd-xxxxx.dedibox.fr/rutorrent/RPC2
So in your DuckieTV rTorrent Integration panel, you would enter the address as http://sd-xxxxx.dedibox.fr, and the Base Path as /rutorrent/RPC2.
This has cropped up a few times before, so I have decided to add these recovery instructions here in the hope they will be useful.
So some external event outside of Dtv's control (Possible examples: You uninstalled a Chrome Browser [Stable, Beta or Canary], or you used the Chrome Browser Cleanup tool, or a system clean up cycle occurred, a system's update cleanup, a disk clean up app [CCleaner or similar], some security app, I don't know what), which has somehow managed to blow away the environment settings that tell Dtv how to access its DataBase (DB).
So now Dtv cannot read/write records from/to the DB.
The simplest way to fix this is the following:
- Shutdown Dtv.
- Use your file manager (with the show hidden files option enabled) to delete the Dtv data folder, which is usually found at:
-
windows:
C:\Users\<username>\AppData\Local\DuckieTV-Standalone -
Linux:
~/.config/DuckieTV-Standalone -
MacOSx:
~/Library/Application Support/DuckieTV-Standalone
-
- Then start Dtv and wait for all the pre-initialisation work to complete (wait a few minutes).
- click on the Import a Backup and provide the location of your Dtv Backup file
- The restore should only take about a couple minutes
- Restart Dtv and you should be good to go.
windows: 
Linux: 
MacOSx: In the event this does not work then raise an issue ticket on Github and ask for help.
- If your DNS is not resolving localhost, you may need to add it to your host table.
For instance, on windows 7, Edit yourC:\Windows\System32\drivers\etc\hostsfile with a plain text editor (such as notepad) and make sure there is an entry that looks like this:
127.0.0.1 localhost
If it looks like this:#127.0.0.1 localhostthen remove the#
If there is an entry like::: localhostthen comment it out to look like this#:: localhost - If the above does not work, then just replace
localhostwith127.0.0.1in the address field of the DuckieTV Torrent Client Integration panel.
So you previously set up DuckieTV Series download paths for your client to use, by following this link but for some reason it is now no longer working.
-
Remember that this only works for the following clients: BiglyBT, Deluge, qBittorrent 3.3.1 (and newer), rTorrent, Transmission, and Vuze
-
Is you client connected? access the Dtv>Settings>xxxxx Integration side-panel (where xxxxx is one of the client names from the list above) and check if the status shows a connection.
In the example below deluge is connected to Dtv
- Remember that if you have shutdown the client while Dtv was active, you will need to also shutdown Dtv before starting the client up first and Dtv second.
-
Is Dtv using the connection? There is an option in the Dtv settings that tells Dtv to use the Chromium/OS interface instead of the Client interface connection when sending magnets/.torrents. This option needs to be turned off.
In the example below the Chromium/OS interface should not get used if the client connection is working
-
Is your client connection Authorised? A connected Status simply means that the port was found to be active, but this does not necessarily mean that Dtv is authorised to sent commands to the client.
-
press F12 to open the DevTools page, and click on the Console Tab to view the log.
-
Enable Debug mode; at the
>prompt pastelocalStorage.setItem('debug982', 'true')and press enter. Then Exit Dtv and Start it up again.
-
Wait for the AutoDownload to send a magnet/.torrent to your client or manually start one using the torrent dialogue
-
Look at the last magnet/.torrent Dtv sent to your client. If you are seeing errors, then hopefully the error points to the problem.
This shows the magnet was sent via the client interface successfully
If its a .torrent you'll see
Adding via TorrentClient.addTorrentByUpload API!
And this shows what the Download path was set to
-
if that Download path is wrong then go to the Series settings side panel and correct the error.
This shows that the magnet/.torrent was sent via the Chromium/OS interface, which does not support download paths.
-
if OpenURL was used instead of TorrentClient then there is something wrong with the setup for your client or Dtv. Check the Setting up Torrent Clients for DuckieTV and scroll down to the Problems? section for help hints.
-
To disable Debug mode use
localStorage.removeItem('debug982')then Exit and Start up Dtv again. -
If Dtv is sending the correct download path but your client is not using it then it is likely that there is a problem with your client app. Check the apps settings, is there an override option to only use the default download path?
-
Enable and look at the client apps logs, perhaps there is a clue to the problem in its error messages.
-
Remember that the Download path must be valid, and that the folder must have been created. Some clients will ignore DLpaths that point to non-existing folders.
-
If you need to bulk edit all the DLPaths on Dtv for whatever reason:
To run these commands , access the DevTools page (on Windows/Linux F12, for MacOS Cmd-Alt-I or if that does not work then right-click on the dtv home page and select inspect) and click on the Console tab to view the log and at the>prompt paste your command and press enter to execute.
These examples are Linux/MacOS, for Windows the path would look something like:C:\tv_shows-
to replace all the dlPath for every series regardless of previous value
CRUD.executeQuery("update Series set dlPath = '/home/plex/tv_shows' ").then(function(result) { console.log(result); }) -
to erase all the dlPath for every series
CRUD.executeQuery("update Series set dlPath = null ").then(function(result) { console.log(result); }) -
to only update the dlPath for series that do not have one already set
CRUD.executeQuery("update Series set dlPath = '/home/plex/tv_shows' where dlPath is null").then(function(result) { console.log(result); }) -
to update the dlPath for series where dlPath is set to a specific value
CRUD.executeQuery("update Series set dlPath = '/home/plex/tv_shows' where dlPath == '/home/old/tv_shows' ").then(function(result) { console.log(result); })
-
I suggest you avoid using these commands while the updating series dialog is active on the main page.
-
If its a .torrent you'll see 
There is an Internal Daily Reset that DuckieTV performs a couple seconds after midnight so that all the schedules and calendar events are set for the new day.
If you want to avoid DuckieTV grabbing focus during this event, then do the following:
Navigate to the Settings > Window side panel, and set the Window on Start-up to Minimised by clicking that button.
You may also want to tick the System Tray check-boxes for Always show Tray Icon and Minimise Button Minimises DuckieTV to Tray.
if you still get this issue after these setting changes, then you may also need to turn the notifications off.
Navigate to the Settings > Display side panel, and disable the Notifications option.
The path to the local DuckieTV database may be different depending on a number of factors:
- the platform OS
- using DuckieTV Standalone
- using Chrome Browser Extensions in Developer Mode, loaded from Unpacked Extension
After a first time installation of DuckieTV the name of the database will be 1, and if the database has been reinitialised, then that number may be incremented by 1 each time, to 2, 3, etc.
In the paths below, <profile> can be one of the following:
- Default
- Profile 1 (or Profile 2, etc)
-
<username>(the current OS login name)
- Nightly
- Standalone (nwjs 0.13.x and newer)
~/.config/DuckieTV-Standalone/<profile>/databases/chrome-extension_bagblfnohpiddokbpaacecffdboomafe_0 - Chrome Browser Extension BrowserAction from the Chrome Web Store
~/.config/Google/Chrome/<profile>/databases/chrome-extension_ikhklcamhmfmjbhckdjoabiepglbhaid_0 - Chrome Browser Extension NewTab from the Chrome Web Store
~/.config/Google/Chrome/<profile>/databases/chrome-extension_jndkngpbgmnkbhbjafmjhabcjmgeogfc_0
- Standalone (nwjs 0.13.x and newer)
- Nightly
- Standalone (nwjs 0.13.x and newer)
~/Library/Application Support/DuckieTV-Standalone/<profile>/databases/chrome-extension_bagblfnohpiddokbpaacecffdboomafe_0 - Chrome Browser Extension BrowserAction from the Chrome Web Store
~/Library/Application Support/Google/Chrome/<profile>/databases/chrome-extension_ikhklcamhmfmjbhckdjoabiepglbhaid_0 - Chrome Browser Extension NewTab from the Chrome Web Store
~/Library/Application Support/Google/Chrome/<profile>/databases/chrome-extension_jndkngpbgmnkbhbjafmjhabcjmgeogfc_0
- Standalone (nwjs 0.13.x and newer)
- Nightly
- Standalone (nwjs 0.13.x and newer)
C:\Users\<username>\AppData\Local\DuckieTV-Standalone\User Data\<profile>\databases\chrome-extension_bagblfnohpiddokbpaacecffdboomafe_0 - Chrome Browser Extension BrowserAction from the Chrome Web Store
C:\Users\<username>\AppData\Local\Google\Chrome\User Data\<profile>\databases\chrome-extension_ikhklcamhmfmjbhckdjoabiepglbhaid_0 - Chrome Browser Extension NewTab from the Chrome Web Store
C:\Users\<username>\AppData\Local\Google\Chrome\User Data\<profile>\databases\chrome-extension_jndkngpbgmnkbhbjafmjhabcjmgeogfc_0
- Standalone (nwjs 0.13.x and newer)
Chrome Browser Developer Mode Unpacked Extension (all platforms)- the id will differ depending on the folder name used to load the extension.
usechrome://profile-internals/and expand the profile for your user to find the profile path.
usechrome://extensions/and view the details for your nightly version, to find the id.
the location of the DB will be the profile path and the folderdatabaseand the folderchrome-extension_<id>_0
First a little background information:
DuckieTV is a Chrome Browser Extension app, written in JavaScript using the AngularJS framework.
The standalone version of DuckieTV is exactly the same code encapsulated by the nwjs run time environment.
So, Chrome Browser security only allows extension apps limited access to a sand-boxed file area within the browser data space. This is not suitable for storing your downloads.
Chrome extensions do not have access to your computer's file system, as this would be an obvious security risk.
So what alternatives are there?
Well there are two:
- You can use the download path option, that is available via some of the torrent clients that DuckieTV can connect to.
For more information on this subject, read this wiki. - You can use a file manager to automatically move your downloads to where ever you want. I can recommend FileBot.
For an example of using FileBot with DuckieTV, read this wiki.
Just install libappindicator1 package and it will start working again.
sudo apt-get install libappindicator1
The NWJS runtime environment that the Standalone Dtv runs under includes Node.js, and recent versions of Node.js require the libatomic1 library.
For now the solution is to just install the libatomic1 package. Open a terminal and run sudo apt-get install libatomic1
Note If you ran Dtv prior to the node install, then there may be stub DuckieTV tasks still active which will prevent DuckietV from starting up after your libatomic1 install is completed.
Simplest way to deal with this is to reboot your machine, or start your System Monitor and kill any DuckieTV stubs.
So you found a red button with TVDB_ID crossed out instead of the usual Find a Torrent button for an episode and the Torrent search dialogue is not available.
Or you were looking at the Auto-Download Status Monitor page and saw TVDB_ID as the reason an episode torrent was not sent to your torrent client.
What gives?
DuckieTV supplements the Trakt.tv data it fetches with information from theXem.info for series alternate titles and season/episodes cross-entity mapping.
This service relies on the TVDBid for its series and episode identification.
However Trakt.tv stopped using the TVDB database back in March 2021 as one of its sources and switched to using TMDB exclusively instead. So now the trakt.tv data that DuckieTV fetches may not include the TVDBid.
To bridge the gap DuckieTV has a manually curated cross reference table to provide missing TVDBids.
So post a request on either reddit or github to get the table updated. Please include a link to any one of TMDB or TVDB or IMDB or Trakt.tv page for the series, to help me identify the correct show to fix.
Once the table is updated, Dtv should fetch it within the next 24 hours. After this you may need to visit the shows series details side panel and press its Refresh button to force an update of the Dtv record for the show. You will know this has worked when the TVDBID link shows up on the details sidepanel, and the Find a torrent button is back to normal.