Tartube

-------------------------------------------------------------------------------

MINOR NEW FEATURES
- MS Windows users have been reporting that FFmpeg cannot be installed any
more; this release attempts to fix that issue (but I can't be sure that the
fix will work)
- In order to cope with yt-dlp spam, added some new ignorable warnings (see
Edit > System preferences... > Windows > Errors/Warnings)
- In Edit > System preferences > Files > URLs, there is a new button for
opening a URL in your system's web browser. Also changed the layout of that
tab to make it a little easier to understand

MAJOR FIXES
- When the Tartube database was corrupted, on startup Tartube was unable to
create temporary directories, so the application closes even before the
main window is created. Fixed that, and also fixed the failure to show a
dialogue window when a lock can't be placed on the database file
- Fixed various issues when exporting/importing Tartube's database
- Fixed inability to rename channels/playlists/folders under certain
circumstances

MINOR FIXES
- Fixed minor typos in various edit windows
- When the downloader is yt-dlp and the user selects a custom executable,
Tartube installs youtube-dl instead. Fixed (Git 299)
- In the same situation (on MS Windows only), Tartube tries to execute an .exe
file as if it were a Python script. Fixed (Git 299)
- On MS Windows, user could not set an external download path for a channel or
playlist. Fixed (Git 329)
- Fixed inability to load databases from Tartrubr v2.2.007 (Git 356)
- Valid URLs like "yahho.com" were not accepted as valid. Fixed

-------------------------------------------------------------------------------

MAJOR NEW FEATURES
- Tartube can extract a video's comments, and optionally store them in its own
database. (In either case, comments are stored in the video's .info.json
file). This feature is only available when using yt-dlp. To enable it,
click 'Edit > System preferences... > Operations > Comments', and select
'When checking/downloading videos, store comments in the metadata file',
(Note that the download option in 'Edit > General download options...' has
been removed). To view comments for a video, right-click the video and
select 'Show video > Properties > Comments'

MINOR NEW FEATURES
- In the preferences window (Edit > System preferences... > Windows > Main
window), the 'Reset' button now resets the position of various sldiers, as
well as the size of the main window
- Added a few more video/audio formats to the list selectable in the download
options window
- In the video slices dialogue window (right-click a video and select 'Special
> Remove video slices...') the user can now opt to remove a slice, or to
remove everything but a slice. The latter behaviour is slightly different
to downloading a video clip, because downloading a clip will create a new
entry in Tartube's database. The new button should clarify what the window
is actually supposed to do (Git 322)
- In the new-ish dialogue window that appears when nothing is downloaded, there
is a new section remnnding Classic Mode users that they can't download a
file that doesn't exist (and what to do about that) (Git 326)
- The same dialogue window appeared after checking a single video that had
previously been checked/downloaded. Fixed
- The setup dialogue window now explains to users what the Classic Mode tab is
for, and lets them specify that the main window should always open at that
tab, if they want

MAJOR FIXES
- The button to set the media file in a video's edit window did not work on
MS Windwos. Fixed (Git 320)
- In the Progress tab, the 'Maximum downloads' setting was broken. Fixed
- Fixed an error caused when a video's upload date (as returned by youtube-dl)
was None

MINOR FIXES
- .webp thumbnails from Odysee (and perhaps other websites) were not converted
into a displayable format; fixed

-------------------------------------------------------------------------------

MAJOR NEW FEATURES
- You can now download videos as a sequence of video clips, or split a video
you've already downloaded into clips. Tartube can extract a list of
timestamps from a video's description, or extract the chapter list from a
video's medadata file. You can also specify your own timestamps. See the
README for details about how this works. Video Clips are added to the new
'Video Clips' folder, by default. This functionality requires FFmpeg
(Git 282)
- Tartube now provides SponsorBlock integration. Tartube can download a video
with the sponsored sections removed. It can also remove sections from a
video you have already downloaded. Tartube can fetch information from
SponsorBlock directly, or you can specify your own video sections to
remove. See the README for details about how this works. This functionality
requires FFmpeg
- Custom downloads have been overhauled. You can now create as many different
custom downloads as you like: click 'Edit > System preferences... >
Operations > Custom' for a list of them. The defautl custom download is
the one called 'general'. A custom download normally involves 'checking'
channels/playlists before 'download'ing them; this can now be done
automatically
- A 'Custom download all' button can be added to the Videos tab, beneath the
'Download all' button, if it's convenient for you. Click 'Edit > System
preferences... > Windows > Main window' and select 'Show a Custom Download
all button in the Videos tab'
- Until now, Tartube has only been able to download videos into its own
data folder. You can now download channels and playlists to any location on
your filesystem. This is not recommended unless you have a good reason (see
the README for a list of good reasons). To change the download destination
for a channel (etc), right-click the channel and select 'Channel actions >
Set download destination...', then in the new window select 'Use an
external location' and click the 'Set' button. When Tartube starts, it
checks that any external locations are readable/writable and, if not, the
channel/playlist's name is drawn with a line through it (Git 296)
- Added a new 'Recent Videos' folder. By default, it shows videos checked/
downloaded during the last download operation. This behaviour can be
changed by right-clicking the folder, and selecting 'Downloads >
Set removal time' or 'Show > Folder properties... > Recent videos'
- Added alternative performance limits (for example, to limit bandwidth at
certains times of the day). To set up these limits, click 'Edit > System
preferences... > Operations > Limits'. When the alternative limits apply,
a grey icon in the Progress tab changes colour. Scheduled downloads also
now have their own alternative performance limits, which override those
specified elsewhere (Git 288)
- You can now bulk-update the URLs for channels and playlists (for example, by
using a regex to modify the ending of each URL). Click 'Edit > System
preferences... > File > URLs'. Double-click a single URL to edit it, or use
the buttons at the bottom of the tab to bulk-edit URLs. The name of the
channels/playlists can also be edited by double-clicking them (Git 286)
- You can now add many channels and playlists at the same time, using a single
dialogue window. Click 'Operations > Add many channels/playlists...'
(Git 222)
- Changed the layout of the Classic Mode tab, to clarify the difference between
a video being downloaded in a particular format, and being converted to
that format after the download has finished. Before, video and audio files
downloaded from the tab were handled inconsistently. Now, a download of an
.mkv file will only fail if the website doesn't provide the video in that
format, and the user has not chosen to convert the file after download
- When a download operation fails to check/download anything, the user will now
see a dialogue window, suggesting some things to do. This should improve
the experience for new users when Tartube fails to work for no obvious
reason

MINOR NEW FEATURES
- It's now possible to export/import Tartube's database as a .CSV file. The
separator is '|' by default; that can be changed in 'Edit > System
preferences... > Files > Backups'. The menu interface for export/import has
been simplified (Git 222)
- When exporting Tartube's database as plain text, it's now possible to
preserve the database's file structure and/or to include a list of videos.
The changes mean that plain text exports from v2.3.206 and earlier will no
longer work. (It is quite simple to edit the exports by hand, if any users
are affected by these changes)
- Exports from Tartube's database (in any format) now include videos inside the
'Unsorted Videos' and 'Video Clips' folders
- Messages in the Errors/Warnings tab now show dates and times. This can be
disabled using the button at the bottom of the tab (Git 281)
- In case Tartube's main window becomes too big for the desktop, added a button
to reset its size in 'Edit > System preferences... > Windows > Main window'
(Git 291)
- When Tartube's main window was minimised to the tray, and then restored, it
was not restored to its old position on the desktop. You can now enable
this behaviour, if you want: click 'Edit > System preferences... >
Windows > Tray', and select 'After closing to the tray, restore the
window's position' (Git 292)
- You can now override youtube-dl download options completely, specifying your
own options explicitly. CLick 'Edit > General download options...', click
the 'Show advanced download options' button if it's visible, then specify
your requirements in the area above (Git 276)
- If users attempt to add a YouTube channel/playlist whose URL does not end in
'.../videos', they will now see a dialogue window with a reminder to click
the YouTube VIDEOS tab, before copying the URL. The reminder can be
disabled in 'Edit > System preferences... > Windows > Dialogues' (Git 286)
- In the Classic Mode tab, the re-download button can now be clicked while
other downloads are still taking place. Therefore, if one video fails to
download, you can force it to re-download without waiting for everything
else to finish (Git 293)
- The maximum number of simultaneous downloads has been increased to 32. This
high setting is not recommended unless you actually want YouTube to ban
your IP (Git 294)
- Changed the maximum line length for video descriptions, stored in Tartube's
database, from 50 to 80 characters (Tartube's main window used to be less
wide by default, so the shorter limit is no longer necessary). You can now
update each video's description in its edit window (right-click the video
and select 'Show video > Properties... > Description'). You can also
update all videos in the database (Edit > System preferences... > Files >
Update'
- The video's edit window has a button for changing the video file, but it
wasn't obvious that the button is clickable. Improved the layout
- You can now change the background colours used in the Video Catalogue by
clicking 'Edit > System preferences... > Windows > Colours'. The default
colours have been tweaked, as they made some clickable labels hard to read
- Replaced the icon used to show a video that's not been checked or downloaded
yet (which improves the look of the Video Catalogue)
- In the Classic Mode tab, if the user forgets to click the 'Add URLs' button
before clicking the 'Download all' button, they will now see a dialogue
window reminding them of what to do
- You can now set channels, playlists and folders so that videos can be
downloaded without updating Tartube's database (in effect, making the
Videos tab behave like the Classic Mode tab). For example, to apply this to
a channel, right-click the channel and select 'Downloads > Don't add videos
to Tartube's database'
- Added the ability for youtube-dl to authenticate using a .netrc file. To
enable this, click 'Edit > General download options...'. Click the 'Show
advanced download options' button if it's visible. Then click 'Advanced >
netrc'. For your convenience, the .netrc file itself can be edited in this
tab. This feature has not been tested on MS Windows yet (Git 305)
- Added a comparable ability to use and edit the youtube-dl configuration file.
Click 'Edit > General download options...'. Click the 'Show advanced
download options' button if it's visible. Then click 'Advanced >
Configurations'
- All download options in the edit window ('Edit > General download
options...') now have a tooltip, showing the actual youtube-dl/yt-dlp
option
- Added a range of download options for yt-dlp only (which cannot be used with
youtube-dl), including '--paths' (Git 299)
- Names of channels and playlists in the Video Catalogue are now clickable,
and will open the channel/playlist URL in your web browser if clicked
- Videos inside folders (for example, inside the 'Unsorted Videos' folder) can
can now be checked, if they have already been checked (for example, by
right-clicking a video and selecting 'Check video'). This is useful for
updating timestamps, chapters and SponsorBlock data
- You can now drag videos from the Video Catalogue into a new channel, playlist
or folder (Git 309)
- The default and alternative locations for Tartube's configuration file are
now visible in the preferences window ('Edit > System preferences... >
Files > Config')
- In the Progress tab, you could already right-click a video and select 'Stop
after these videos'. Added a corresponding item to the main window's menu
- After stopping a download manually (for example by clicking the 'Stop' button
in the main toolbar), items that were marked as 'Waiting' and marked as
'Not started'. This might relieve some confusion

MAJOR FIXES
- On MS Windows, it was not possible to install yt-dlp because of MSYS2 issues.
Tartube will now install yt-dlp without dependencies, by default, which
fixes the problem. This behaviour can be changed in 'Edit > System
preferences... > Downloaders > Forks' (Git 269, 279)
- Also fixed yt-dlp dependency issues (Git 317)
- Fixed an error on startup, occuring when Tartube was unable to load its
default database, and started checking for others
- Fixed an error that failed to load Tartube's configuration file created
between versions v1.3.088 - v2.3.149
- Fixed an error that affected all list values in the edit windows for
download options and FFmpeg options, while using those windows
- Fixed an error that made radio buttons unusable in some edit windows
- Fixed an error that failed to open the preferences window from the Classic
Mode tab's menu
- Download options for deleting the video description, metadata, annotations
and thumbnail files after downloading the video were ignored in the Classic
Mode tab, when enabled. Fixed (Git 295)
- The main window's 'Add video' and 'Custom download all' buttons did not work,
after loading a database created by v2.3.110. Fixed (Git 307)
- Fixed an error that occured when renaming channels/playlists/folders in
certain circumstances
- After disabling checking and/or downloading videos for a folder, checking/
downloading for any child channels/playlists/folders was also supposed to
be disabled, but this did not work as intended. The original behaviour has
been changed, so that enabling/disabling the settings does not apply to a
folder's children
- The setting to move a video's metadata files to a sub-directory did not work
as intended. Code to detect a thumbnail's likely location had become
garbled. Both fixed
- Fixed a rare error when trying to delete a channel/playlist
- Fixed an error that prevented the download of Japanese-language videos from
finishing. Updated related code to improve the handling of non-UTF-8 text
in general (Git 308)
- Fixed failure to obtain the path to Tartube's config file (Git 314)
- Fixed problems with an incomplete list of folders (for example, in the
'Add channel' dialogue window (Git 316)

MINOR FIXES
- Several users have complained that some icons are not visible in the main
window. This seems to be an issue with incorrect (or broken) installation
of the Gtk library on certain distributions. Tartube now uses its own
icons, by default, rather than the stock Gtk icons. This behaviour can be
changed in 'Edit > System preferences... > Windows > Main Window'
- Some Tartube icons were a little difficult to see, so they have been switched
for better icons
- Fixed .bat files in the MS Windows installers, so that Tartube starts when
Python 2 is installed (Git 271)
- Small improvements to the layouts of various dialogue windows
- In the Progress tab, the button 'Max downloads' was not actually used by
anything, nor was its setting remembered after restarting Tartube. This has
been fixed. When the button is not selected, a default maximum of two
simultaneous downloads applies
- Disabled the instruction to show a youtube-dl system command for Tartube
folders (which have no URL for youtube-dl to use)
- Fixed a faulty dialogue window when dragging a channel/playlist/folder into
the 'Temporary Videos' folder
- Fixed problems downloading videos as audio from the FFmpeg options window
- Fixed problems in the download options edit window, in the 'Sound only' tab
(downloading as audio could be enabled, but not disabled)
- Fixed problems in which the edit window for a video's properties could not
be opened, if the video's file size was unknown, or if Tartube's custom
icons were enabled
- When the user fetches a list of video formats, Tartube now switches to the
Output tab automatically
- When custom downloads are enabled in the Classic Mode tab, the 'Download all'
button is replaced by a 'Custom download all' button, for clarity
- Video sizes are displayed in the Video Catalogue, but empty space was visible
instead of 'Unknown' when the file size was not known. Fixed
- Minor fixes to the popup menus in the Video Catalogue
- The youtube-dl 'Download did not start' message is now visible in the Output
tab, as well as the Errors/Warnings tab
- Continuing locale problems are not yet resolved, but the code will now use
the actual locale, rather than defaulting to UTF-8 (on Linux) and cp1252
(on MS Windows)
- Fixed typo in the 'stalled' stage of a video download, which might have
caused problems
- Fixed broken button in System Preferences window (Git 224)

-------------------------------------------------------------------------------

MAJOR NEW FEATURES
- Added the Korean translation compiled by mirusu400 (thanks!) (Git 258)
- Tartube now officially supports the downloader yt-dlp, replacing its support
for youtube-dlc (which has been abandoned) (Git 254)

MINOR NEW FEATURES
- The FFmpeg options window now provides comboboxes for the user to specify
GPU encoding and hardware acceleration (Git 264)
- In the download options edit window, under the 'Files > Keep files' tab, the
text has been improved to more accurately describe the handling of
description, metadata, annotation and thumbnail files (Git 263)
- In Tartube's setup.py, replaced the obsolete dependency pgi with pygobject
(Git 242)

MAJOR FIXES
- In the download options edit window, in the Subtitles > Options tab, the
button marked 'Download subtitles file for these languages' was completely
broken. Fixed (Git 263)
- Users who installed Tartube using one of the 'strict' packages reported that
the preferences window could not be opened. The problem has probably been
fixed (Git 256)

MINOR FIXES
- In the Videos tab, the 'Download all' button can be disabled. Other buttons/
menu items are disabled at the same time. Download buttons in the Classic
Mode tab were disabled, but should not have been. Fixed
- When installing yt-dlp via pip, the version number was not recognised. Fixed
- In the download options edit window, in the 'Files > File names' tab, there
was a duplicate label in the 'Video properties' combobox. Fixed (Git 263)
- Fixed a rare crash caused by an incorrectly detected videos
- Various fixes for Git 243, Git 249

-------------------------------------------------------------------------------

MAJOR NEW FEATURES
- Added the Dutch translation compiled by Heimen Stoffels (thanks, Heimen!)
(Git 244)
- Tartube can now display statistics about the channels and playlists in your
database, and about the database as a whole. These are visible in the
preferences window, and in the channel/playlist properties windows. If
matplotlib is installed on your system, Tartube can draw graphs showing
your download history. For help with installing matplotlib on MS Windows,
see the README (Git 235)
- Added a new system folder called 'Recent videos'. It shows all videos
checked/downloaded during the most recent download operation. Browsing this
folder is perhaps more convenient than using the lists in the Progress and
Classic Mode tabs
- You can specify a custom path to the youtube-dl(c) executable. This is not
recommended in general, but it might be useful for testing purposes
(Git 243)

MINOR NEW FEATURES
- Added a menu item to check for new releases of Tartube (click Help > Check
for updates). This function downloads simple text files from Tartube's
websites, and should not collect any information about you. If you're still
worried about privacy, don't use the feature. You can see exactly what is
being downloaded in the Output tab (Git 216, 234 and others)
- The path to youtube-dl(c)'s cookie jar file can now be customised, for
example in Edit > General download options... > Files Cookies. If not
customised, Tartube creates a cookie jar file in Tartube's main data folder
(directory), as before (Git 240)
- Several improvements to the Classic Mode tab. After clicking the 'Add URLs'
button, any duplicate URLs (which are not copied from the top half to the
bottom half) can optionally be deleted now. Click Edit > System
preferences... > Windows > Main window, and select 'In the Classic Mode
tab, when adding URLs, remove duplicates rather than retaining them' (Git
233)
- The first error generated when downloading a video/channel/playlist is now
visible in the tooltip (in both the Progress and Classic Mode tabs). The
behaviour can be disabled: click Edit > System preferences... > Windows
> Main Window, and deselect 'Show errors/warnings in tooltips'. This is a
compromise for showing the full error message in the tabs, which is
not practical due to youtube-dl(c) limitations (Git 233)
- In the Classic Mode tab, after a download has finished, the name of the
video file is no longer cleared, in order to assist with identifying
failed downloads (Git 233)
- In the Videos tab, all status icons are now visible for all videos, even when
thumbnails are not drawn (Git 233)
- In the Classic Mode tab, added a new 'Clear downloaded' button (Git 233)

MAJOR FIXES
- Fixed the 'No translation file found for domain: base' crashes (Git 245,
247)
- Apparent fix for crashes while downloading videos from LinkedIn Video. The
fix has not been fully tested yet (Git 240)
- Fixed the re-download button in the Classic Mode tab, which was completely
broken
- Fixed several problems with translations, which only became apparent after
someone submitted a translation file

MINOR FIXES
- In the Videos tab, when a video is marked as 'Can't D/L', right-clicking the
video to download it caused a crash. Fixed
- In the Classic Mode tab, if duplicate URLs are added in the top half, then
both are added to the bottom half after clicking the 'Add URLs' button.
Fixed (Git 233)
- In the Classic Mode tab, the 'Download all' button re-downloaded a video that
had already been downloaded. Fixed (Git 233)
- It was not possible to mark multiple videos as not livestreams in a single
action. Fixed
- After switching the system language in the preferences window, Tartube
displayed the wrong icon. Fixed

-------------------------------------------------------------------------------

MAJOR NEW FEATURES
- youtube-dl(c) allows you to specify a proxy for downloading videos. This
version allows you to specify a list of proxies (in Edit > System
preferences... > Operations > Proxies). When downloading videos, Tartube
will cycle through these proxies, one by one. A new proxy is used for
each channel, each playlist, or each video in a folder (it is not possible
to switch proxies during the download of a single channel or playlist). If
you have specified a proxy in download options (for example, in Edit >
General download options > Advanced > Network), then that proxy overrides
the new list (Git 226)

MINOR NEW FEATURES
- You can now change the path to the video file. This might be useful in
several scenarios: for example, if you've converted a video file to an
audio file, or if you've changed the file name format, and have re-
downloaded a video. To change the path, right-click a video and select
'Show video > Properties...'. In the edit window, find the line marked
'File'. There is a new button there that can be clicked in order to
change the file path. For the sake of consistency, only video/audio files
in the same directory/folder can be set (Git 211)
- In case the preference window cannot be opened (because of some python
error or other), a database integrity check can now be launched directly
from the main window's menu (File > Check database integrity)
- Sets of download options and FFmpeg options can now be cloned. When applying
download options to a video/channel/playlist/folder, you can now select an
existing set of download options, or clone an existing set, or create a new
set (Git 224)
- The copy of Youtube Stream Capture bundled along with Tartube has been
updated to the latest release

MAJOR FIXES
- Found a fix for (uncommon) crashes on MS Windows, in the setup window for new
installations, and a fix for (common) problems in keeping the textview
updated when youtube-dl(c) and/or FFmpeg are being downloaded from the
seutp window (Git 212)
- More fixes for stalled video downloads. Tartube is now sensitive to some
new network problems, and in that situation can restart the download
immediately, rather than waiting some minutes. The new behaviour is
disabled by default. To enable it, click Edit > System preferences...
> Operations > Downloads, and select 'If a network problem is detected,
restart the download immediately'. I still have not been able to reproduce
a stalled download, but the restart process should work more smoothly now
(Git 174)
- If downloading subtitles was enabled, Tartube mistook the path to the
subtitles file for the path to the video file. This should be fixed now
(Git 211)
- In the Classic Mode tab, the button to re-download a video was broken. Fixed
it (Git 218)
- Fixed a broken dialogue window, when Tartube runs out of disk space for
downloading videos, which caused a crash (Git 217)
- A refresh operation failed to notice audio files, as well as video files. It
now recognised both (Git 225)
- Some users have reported problems associated with download options (Git 228,
among others). I am not sure about the cause of these issues yet, but I
have been able to fix a couple of errors in the code (one major, one
minor). These errors may be responsible for the reported issues, or not
- Fixed folders that vanish when being dragged and dropped into other folders
(MS Windows only), and fixed associated broken dialogue windows (Git 232)

MINOR FIXES
- After a period of continuous operation, without checking/download videos,
live/debut videos could change their status, but the order of videos in the
Videos tab was not updated. Live/debut videos are supposed to be listed
first, before all other videos; this should now be working better
- Times in the Errors/Warnings tab were shown in UTC, instead of the user's
local time zone. The same problem applied to metadata in Tartube's saved
data files. Fixed both (Git 213)
- The size of the main window, and the position of the slider in the Videos
tab, can be remembered between sessions (see the options in 'Edit > System
preference... > Windows > Main winndow'). However, the position of the
slider was not set correctly on MS Windows. Fixed that, and also added a
separate setting so that the window size, but not the slider position,
can be remembered (if that's what you want). If remembering the slider
position is enabled, Tartube will now remember the position of all three
sliders (Git 215)
- You can download a video, then apply download options directly to the video,
then modify the options to change the download video's filename, then
re-download the video. The original video is deleted, but not its metadata
files. The redownload button in the Classic Mode tab did not delete the
original video or its metadata files in this situation. Fixed both
(Git 219)
- Fixed a few annoying dialogue windows which, when closed, pushed the main
window to the fore, instead of the preference window
- When video catalogues are listed without thumbnails at all, but sorted by
download (receive) time, the upload time was displayed instead. Fixed
- At the bottom of the videos tab is a toolbar which can be partially hidden.
On startup, when not fully hidden, the toolbar can now be partially hidden
before any videos are displayed