Tartube

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

MAJOR NEW FEATURES
- YouTube Stream Converter has been deprecated, so Tartube no longer supports
it. Instead, Tartube now offers livestream downloads using streamlink
(https://streamlink.github.io/) or with the video's .m3u manifest
- Livestream detection now works on Odysee and Twitch, as well as on YouTube.
Detection should work on other websites, if you set the RSS feed for the
channel and playlist manually (see the README for details)
- In the toolbar at the bottom of the Videos tab, you can now filter out
downloaded videos, or undownloaded videos. These settings are ignored when
a text search/filter is applied; in that situation, the buttons are now
greyed out for clarity (Git 402)

MINOR NEW FEATURES
- When videos are being checked/downloaded, you can now see the amount of free
disk space in the bottom-left corner of the Videos tab
- Added the youtube-dl download options '--no-overwrites', settable from the
edit window (Git 398)
- Videos with enormous names, but without any space characters, created a
tooltip that was longer than the Tartube window itself. Updated line-
wrapping code generally, so that it will wrap on underline (underscore)
characters, as well as on whitespace
- Column headers in the Errors/Warnings tab are now resizeable (Git 403)
- There is now a setting to remove a video from Tartube's database after a
certain number of days, complementing the existing setting to delete the
video entirely from the user's filesystem. See Edit > System preferences...
> Files > Videos. The minimum value is now 0, so users can remove a
downloaded video from the database as soon as it has been downloaded, if
they want to (Git 404)
- In the download options window, Files > File names tab, the 'autonumber'
component has been replaced with 'video_autonumber' and
'playlist_autonumber' components, on the advice of the yt-dlp developers
(Git 406)

MAJOR FIXES
- JSON timeouts were causing havoc when checking a video with lots of comments.
Tartube now provides two timeout settings: one for checking videos with
comments, and one for checking videos without comments. To set them, click
Edit > System preferences... > Operations > Downloads. Also fixed an
error that failed to store comments in the database, under certain
circumstances. Also added a new setting, so that comments can be stored in
the database when checking videos, or when downloading videos (see Edit >
System preferences... > Operations > Comments) (Git 398)
- Fixed problems with the Drag and Drop tab, causing python errors on startup
(Git 399)
- On running out of disk space, load/save was disabled, so the user could not
free up space before saving the Tartube database. This no longer happens,
but after such an error, no scheduled downloads are started (this is
confirmed by a message in the Errors/Warnings tab). Updated the text in the
preferences window for clarity, and to show free space in GB rather than MB
(Git 400)
- Fixed failure to extract a video's URL and duration on certain channels, on
MS Windows (Git 373)
- Fix inability to load database from an (unspecified) earlier version of
Tartube. The error can also be fixed in the existing database integrity
check (Git 405)

MINOR FIXES
- On MS Windows, the download option '--windows-filenames' is automatically
added, but in the edit window, the same option is not selected. Fixed, so
that the option is no longer automatically added, but added only when
selected (Git 373)
- The download option '--trim-filenames' uses a file length that refers to the
absolute path, including the directory. Tartube will now ignore the setting
if the length is less than the absolute path of the directory itself, to
prevents files being downloaded into the wrong place. Added a warning about
the option's unexpected behaviour in the window
- The installer for MS Windows now starts Tartube with an environment variable,
that prevents Gtk from hiding scrollbars (Git 401)
- In the toolbar at the bottom of the Videos tab, the buttons to toggle
drawing frames and icons were set the wrong way around. Fixed
- The YouTube 'This live event will begin in 11 minutes' was not recognised as
a livestream notification (in some circumstances). Fixed
- On startup, in the Classic Mode tab, the 'Convert to this format' and
'Download in this format' buttons were not set or (de)sensitised correctly.
Fixed
- In the download options window, Files > File names tab, the various 'Add'
buttons added components to the end of the file extension, rather than the
end of the filename. Fixed
- Videos/channels/playlists/folders can no longer be deleted from the popup
menus, when preferences or edit windows are open. This should prevent
windows belonging to deleted items being visible
- Fixed display problems when moving a channel/playlist/folder to the top
level, or dragging one onto another
- All keyboard shortcuts have been checked and updated

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

MAJOR NEW FEATURES
- Each channel/playlist/folder in the Videos tab now has a checkbutton. You
can select one or more items, if you want to check/download just those
items. Click the buttons in the bottom-left corner to do that. Even when
items are selected, you can still download everything using the main menu
or from the toolbar. The checkbuttons can be hidden, if you don't want
them: click Edit > System preferences... > Videos, and de-select 'Allow
each row to be marked for checking/downloading' (Git 379)
- New Drag and Drop tab. The tab is divided into a grid. Each zone represents a
set of download options. Drag and drop a video from your browser (or a
text URL) onto one of these zones, and it is added to the Classic Mode tab,
ready for download using the specified download options. Because of Gtk
issues, drag and drop from a browser does not work well on MS Windows.
All users will receive a new set of download options called 'mp3', unless
they already have one with that name
- The layout of the Errors/Warnings tab has been redesigned. It is now fully
searchable. All the checkbuttons like 'Show Tartube errors' are now
applied immediately, and are reversible. (Previously, they only applied to
errors/warnings received in the future)

MINOR NEW FEATURES
- The Classic Mode tab has a new button at the bottom of the tab. When
selected, youtube-dl creates an archive file. This is not recommended in
most cases; it might be useful for downloading large channels/playlists, if
the download might need to be resumed after an interruption (Git 285)
- In the download options windows (e.g. Edit > General download options...),
when advanced options are visible, the options were previously in a
separate yt-dlp tab have been merged into the other tabs. This is because
yt-dlp is now the default downloader for nearly all users
- The layouts in the preferences window and several other edit windows have
been improved (includes Git 360)
- Custom downloads can now skip broadcasting livestreams, or livestreams that
have already finished. They can also skip all videos EXCEPT current/former
livestreams. New icons in the Videos tab highlights which videos are
former livestreams; one for downloaded videos, one for checked videos
(Git 358)
- Tartube can now open in the system tray. See the new setting in Edit >
System preferences > Windows > Tray (Git 365)
- Tidy operations can now remove videos without URLs, or duplicate videos, from
the Tartube database
- In the video properties window, Timestamps tab, you can now update the list
of timestamps manually by clicking the new 'Reset list using copied text'
button, and then copy-pasting text into the dialogue window (for example,
from the video's description) (Git 330)
- Minor changes to the layout of the main window's menu

MAJOR FIXES
- The dialogue windows for adding channels, playlists and folder dialogues
accepted invalid characters and names. Fixed to prevent illegel directory/
folder names on MS Windows, Linux and MacOS (Git 335)
- A 'blocked' video (e.g. an age-restricted video from YouTube) remains
invisible in the Videos tab, by default, even after it is successfully
checked or downloaded (for example, after the user has supplied login
credentials). Fixed
- Errors/warnings assigned by Tartube to an individual video were not cleared
when the video was checked/downloaded without further errors/warnings.
Fixed
- Fixed more crashes due to Gtk issues
- The download options window could not be opened, when the
'--cookies-from-browser' option was set with KEYRING and PROFILE
components. Fixed (Git 394)
- Fix python error when starting Tartube (Git 366)
- Fixed video duplication error when downloading videos that already exist on
the filesystem
- After right-clicking a video and selecting 'Special > Download video clips'
or 'Special > Remove video slices', the dialogue windows had several
serious issues. Fixed them
- In the Classic Mode tab, when a channel/playlist download is interrupted
before the download is complete, the URL is not remembered for the next
session. Fixed (Git 285)

MINOR FIXES
- When checking/downloading produces no new videos, a 'newbie' dialogue is
displayed pointing the user to possible solutions. The dialogue was
displayed even when youtube-dl encountered videos that had already been
downloaded, or that were registered in youtube-dl's archive file. This no
longer happens (Git 368)
- In the preferences window, Windows > Videos tab, the 'Show today and
yesterday as the date, when possible' setting could not be disabled, once
enabled. Fixed
- In the edit window for custom downloads, in the Slices tab, the toggle
buttons were all broken. Fixed them
- After right-clicking a folder and selecting 'Folder contents > All contents >
Empty folder', the text of the dialogue window was gibberish. For this
procedure and related ones, improved the dialogue layout and tightened up
the code. When emptying videos/channels/playlists/folders from the
database (but not removing files on the filesystem), added a new
confirmation dialogue (Git 332)
- The video properties window did not show clip/chapter titles. Fixed
(Git 330)
- Improved wording in the 'Add channel' dialogue, specifically to remove the
word 'automatically'. Updated the video/playlist/folder dialogues too
(Git 277)

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

MAJOR NEW FEATURES
- YouTube has stepped up its efforts to block videos, so uesrs are experiencing
more errors than normal. In these cases, Tartube will now add a video to
its database, marked as blocked/unavailable for download. This behaviour
can be disabled in Edit > System preferences... > Operations > Downloads.
Blocked videos are not normally visible in the Videos tab; to make them
visible, expand the toolbar at the bottom of the tab, and select 'Show
blocked videos'. Blocked videos are always visible when a filter is applied
(as long as they match the filter)
- Scheduled downloads can now be set to start at certain of the day and week,
or at some specified time after Tartube starts (Git 362)
- In the Classic Mode tab, you can now select a video resolution as well as a
video/audio format. Both settings, if set, override download options. The
resolution setting does not require FFmpeg/AVConv

MINOR NEW FEATURES
- Users on MS Windows can now install matplotlib from the main window menu.
When installed, it's possible to see graphs showing your download history
(for example, in Edit > System preferences... > Files > History)

MAJOR FIXES
- Fixed unusable installers on all platforms except MS Windows, in the v2.3.447
release (Git 389)
- Fixed frequent crashes when downloads in the Classic Mode tab fail to
download anything
- youtube-dl errors and warnings are now assigned to individual videos, rather
than to their parent channels/playlists/folders. There is some guesswork
involved, but it should be accurate enough for most users. In the Output
tab, errors and warnings now appear in real time in their original order,
rather than at the end of the output, after the download has finished
(Git 321, 170 and others)
- In the list in the bottom half of the Progress tab, the popup menu items
'Stop after this video' and 'Stop after these videos' produced an
annoying unnamed video, because the child process was halted before the
FFmpeg file merge could take place. Fixed
- Attemps to restart a stalled download (see the settings in Edit > System
preferences window... > Operations > Downloads) did not work as intended.
Should be fixed, although testing has been difficult (Git 174)
- Fixed incorrect timing between the first and subsequent occurences of a
scheduled download
- Fixed broken re-download button/menu item in the Classic Mode tab

MINOR FIXES
- Fixed the faulty layout in the preferences window, in the Windows >
Errors/Warnings tab. Moved the 'Ignore' buttons to a new tab,
Operations > Ignore
- In the main window's menu, the option to install FFmpeg should be
desensitised on all system except MS Windows. In certain circumstances, it
become re-resensitised. Fixed
- In download options, the option to 'Write video's annotations to an
.annotations file' is now disabled by default (since most website do not
provide annotations any more, and in that case the option, when enabled,
creates error messages)
- When updating/installing youtube-dl (etc) from PyPI, and the user already
has the current version installed, fixed faulty detection of the version
number
- In the preferences window, Downloads > File paths, removed the useless
'Local path' setting on MS Windows

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

INSTALLERS
- The installer for 32bit Windows has been retired. See the README for more
details

MAJOR NEW FEATURES
- Gtk stability issues have been resolved (hopefully). This means that, when
checking or download videos, the Videos tab is updated in real time
(without the need to switch between channels/playlists/folders to update
them). This was actually Tartube's oldest unresolved issue
- Tartube can now scan a YouTube channel for its playlists, and optionally
add some or all of those playlists to Tartube's database. See the README
for details of how it works (Git 102)
- In the toolbar at the bottom of the Videos tab, you can now search for
comments and video descriptions, as well as video names. (Don't forget to
click the 'Show more settings' button, so that the full toolbar is
visible). You can also search for comments within a specific video by
right-clicking it, and selecting Show video > Properties... > Comments.
Also improved the layout of that tab a little
- In the Video tab's list, users will now see an icon for any channel/playlist/
folder for which checking/downloading has been disabled. This replaces the
old system of names with italics and underlines, and it should be much
clearer. The old system still applies when small icons are used (Git 385
and others)
- When the user fetches a video's list of formats (by right-clicking the video
and selecting Fetch > Available formats), they will now see a new dialogue
window inviting them to set download options, so the video can be
downloaded in one of the available formats. There is also a new dialogue
window when fetching a video's list of subtitles (Git 369)
- Custom downloads now have the ability to download only videos with subtitles.
In the Videos tab, you can see a new icon next to videos for which
subtitles are available. (The new icon does not mean that subtitles have
been downloaded.) Live chat replay on YouTube videos are treated the same
way as subtitles, and can be downloaded
- Users with a YouTube account can now import their subscriptions directly into
Tartube's database. Click Media > Import YouTube subscriptions..., and then
follow the window's instructions
- There are several situations in which a channel/playlist may be added to
Tartube's database with a generic name (for example, after clicking
Media > Add many channels/playlists...). Tartube can now reset channel/
playlist names automatically, as long as one video in each has been
checked/downloaded: click Media > Reset channel/playlist names...

MINOR NEW FEATURES
- The download options window has been reorganised to clarify, especially to
new users, how to download and then convert videos from one media format to
another. The Classic Mode tab's layout has also been updated with the same
aim in mind (Git 383)
- In the download options window, Formats tab, you can now click the new small
button next to the Add format button, in which you can type a media format
number (e.g. 397) instead of scrolling through the list to find it
- In the download options window, added the '--no-cookies' option and other
related options to the new yt-dlp > Cookies tab (Git 378)
- On MS Windows, advanced users who wish to tweak the environment in which
Tartube runs can now open the MSYS2 terminal window directly from
Tartube's main menu. Tartube's installation folders can also be opened for
inspection. Open the new System menu column to use them
- In the Classic Mode tab, the buttons at the bottom of the tab have been
rearranged. A new 'open destination' button has been added. The popup menu
displayed by right-clicking items in the progress list has been expanded to
duplicate the actions of those buttons
- On MS Windows, when using yt-dlp, the download option '--windows-filenames'
is now automatically applied if '--restrict-filenames' has not been applied
- Updates to the MS Windows installer to improve various issues
- The location of the archive file used by youtube-dl can now be fully
customised. See Edit > System preferences... > Operations > Archive. When
re-downloading a video, Tartube no longer renames the archive file
temporarily, just ignores it (Git 299)
- The annoying 'Unable to download video thumbnail: HTTP Error 404: Not found'
messages generated by yt-dlp are now filtered out by default; they can be
re-enabled in Edit > System preferences... > Windows > Errors/Warnings
- On systems that permit it, the main window's icon in the taskbar is now a
different colour to the icon used by other Tartube windows
- During a custom download, if videos are checked before being downloaded
individually, you can now right-click any video in the Progress tab to
skip the checking phase
- The standard error and warning icons have been tweaked to make it easier to
tell them apart
- On MS Windows, the setup wizard window now warns users about the size of the
youtube-dl/FFmpeg downloads (in case they are installing Tartube on a small
device, such as a pen drive)
- When Tartube loads a database file, it performs various checks. If the checks
fail, the file cannot be loaded. There is a new option to extract a list
of channels/playlists from a database file that cannot be loaded, as long
as the file is not actually corrupted. Click File > Database
preferences... > Dump database to JSON. The JSON file can be re-imported
into any other database in the normal way. Note that, due to python issues,
it is not possible to load or dump any database from Tartube v1.1.0 or
earlier (Git 356)
- Dialogue windows can cause Tartube to freeze, when running on an MS Windows
host in Virtualbox. In that case, dialogue windows can now be disabled
altogether in Edit > System preferences... > Windows > Dialogues

MAJOR FIXES
- Deleting a channel, playlist or folder containing hundreds of videos is now
much faster (orders of magnitude faster, in fact)
- In the Video Catalogue, when a 2-dimensional grid is visible, when using the
cursor (or page down) keys to scroll down the list of videos, the user
would never reach the final row if is was only partially full. Fixed
- Fixed yt-dlp download options '--prefer-insecure' and '--abort-on-error',
which could not be used because of a typo in the code (Git 364)
- On Linux, improved auto-detection of a PyPI install of youtube-dl/yt-dlp; it
is now selected as the default, even if another installation is present
- Fixed an error in the 'Set download destination' window for channels/
playlists, which showed (in the 'Use a different location' box) the most
recent change for any channel/playlist, not the actual location assigned
to this channel/playlist
- In the Progress tab, fixed Python errors when right-clicking a video and
selecting 'Stop after these videos'
- In the Videos tab, when some system folders are open (for example, 'New
Videos'), a deleted video does not disappear from view straight away. Fixed

MINOR FIXES
- After checking videos finishes, the dialogue window now shows the number of
new checked videos, not the total number of videos checked
- The media format selection in the Classic Mode tab was stored with useless
leading zeroes. Fixed
- In the download options window, fixed a typo in the media format 571
- When installing yt-dlp in the setup wizard window, user would see
'Update operation complete, youtube-dl version XXX'. Fixed
- When updating yt-dlp, but the user already has the latest version, the
dialogue window displayed 'yt-dlp version: (unknown)'. Fixed
- Fixed typos in translation files (Git 334)
- The Add Channel dialogue window was not resized correctly when the warning
about correct URLs was removed. Fixed
- In the preferences window, Operations > Livestreams, added a note to explain
that disabling YTSC option does not necessarily prevent all current
livestreams from being downloaded (Git 361)
- In the toolbar at the bottom of the Videos tab, the 'Show icons' button was
not set correctly. Fixed
- In the 'Add videos' dialogue window, when there were too many duplicate
URLs, the window was bigger than the available desktop. Added a scrolling
window to fix the problem (Git 351)

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

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