Tartube

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

IMPORTANT INFORMATION
- youtube-dl is now classed as 'not recommended for most users'. Note that, as
of February 2023, youtube-dl can no longer download any YouTube video (but
other video websites might still work)
- Tartube's 'portable' installer (for MS Windows) is not working as intended,
due to an unresolved Python issue. You cannot move the installation folder
from one location to another, after you have used it to install yt-dlp
and/or FFmpeg. As a workaround, you can place multiple copies of the
original 'portable' installer on your filesystem; for each copy, you should
install yt-dlp and FFmpeg separately. (Each copy can still share the same
video download folder.)

MAJOR NEW FEATURES
- While checking/downloading videos, the Progress tab now shows the average
download speed, total disk space consumed, and the total number of
checked/downloaded videos

MINOR NEW FEATURES
- In the Progress tab and Classic Mode tab, the width of columns can be
adjusted. For the benefit of users with very large monitors, it's now
possible for Tartube to remember the adjusted widths of some columns which
tend to contain a lot of text (but not those which contain very little
text). To enable the setting, select Edit > System preferences... >
Windows > Main window > In the Progress/Classic Mode tabs, remember the
width of (some) columns (Git 509)
- In the Errors/Warnings tab, in multi-line error messages, empty lines are
now ignored (leaving just the lines that actually contain visible text)
- In the Progress tab, in the bottom half of the window, you can now right-
click a video and select the new 'Show video location' option
- Enlarged and updated the screenshots in the tutorial (Help >
Show tutorial...) so the detail is much easier to see
- Added numerous translator's notes throughout the code; these are visible to
anyone working on a translation (such as users of weblate.org)
- yt-dlp sometimes downloads videos from VK, whose file extension is set to
.unknown_video instead of .mp4. As temporary mitigation for this problem,
you can now auto-convert those videos (Operations > Tidy up files >
convert '.unknown_video' file extensions to .mp4), and then update
Tartube's database (Operations > Refresh database...) (Git 472)

MAJOR FIXES
- Fixed auto-detection of yt-dlp installation location, when it has been
installed from PyPI. This issue did not affect MS Windows users
- The Classic Mode tab was unable to download videos as .m4a files, fixed
(Git 506)
- In the Progress tab, the column showing the number of videos downloads (e.g.
5/14) was not working again, due to another change in yt-dlp's behaviour.
Fixed it again (Git 504)
- Fixed problems when looking for livestreams from websites whose metadata
doesn't specify an 'is_live' field
- Fixed failure to load a Tartube config file from v.2.3.110 (Git 510)

MINOR FIXES
- The tutorial (Help > Show tutorial...) was missing its second page. Restored
it
- Fixed incorrect version format in desktop file (Git 496)
- Fixed rare failure to load database, because of change to its structure in
v2.4.213 (Git 498)
- On MS Windows only, when opening the MSYS2 terminal from Tartube's menu,
the dialogue window, when closed by the user, caused the terminal window
itself to be hidden behind the main window. Fixed

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

MAJOR NEW FEATURES
- Added complete French translation and partial Turkish translation. Thanks to
sydney and PUFF1N
- In the toolbar at the bottom of the Videos tab, added the ability to reverse
sort and to sort by numbers in each video's title (for example, so that
'Alan's video 2' can appear before 'My video 1'; so-called 'natural'
sorting). Sort settings are now stored in Tartube's database, not in its
config file (so Tartube will remember which databases are currently reverse
sorted, and which are not, for example) (Git 477)

MINOR NEW FEATURES
- Handling of locales has been overhauled. Tartube will still switch to your
system's locale automatically (when translations are available for it) but,
if you prefer, you can force Tartube to use any of the available
translations. To do this, open Edit > System preferences (Git 471)
- In the Progress/Classic Mode tabs, while checking/downloading videos,
improved the format of the column which usually displays '6/9' (meaning 6
out of 9 videos downloaded). In some situations, it displayed information
whose meaning was not clear (Git 474)
- In the Progress/Classic Mode tabs, in the popup menus, enabled the 'Stop
after this video' option for videos that haven't started downloading yet
(Git 481)
- Added the yt-dlp option '--abort-on-unavailable-fragment' to Tartube's
download options windows (Git 475)
- Added a few new pages to the tutorial (Help > Show tutorial...). In Tartube's
setup window, added some emphasis to the button that opens the tutorial,
so that more new users notice it
- In the toolbar at the top of Tartube's main window, added new buttons to
open preferences and download options
- Updated the imported XDG code by Scott Stevenson to v5.1.1
- Improved the way users start custom downloads, for example by clicking the
'Custom download all' button optionally visible in the bottom-left corner
of the Videos tab. Now, if only the standard "general" custom download
exists, that is the custom download that starts. If additional custom
downloads exist, the user is prompted to choose one. This replaces the old
system in which two buttons were visible. Popup menus have been modified in
the same way, but the main menu is unaffected
- Videos are displayed in the Videos tab in a variety of styles (including
lists and grids). Users could already cycle through the styles using the
button in the main toolbar, but now it's possible to select one directly
through the main menu (Media > Switch between views) (Git 487)

MAJOR FIXES
- When the 'Add videos to the Missing folder' setting is enabled, downloading a
channel caused all of the channel's videos to be added to that folder.
Fixed, and fixed some related issues with yt-dlp custom templates
(Git 473)
- While downloading videos, the format of yt-dlp's output has recently changed,
as a result Tartube could no longer extract the ETA (and other similar
values). Fixed (Git 472)
- In the Classic Mode tab, one-click downloads worked once, then not again.
Fixed
- Fixed a Python error which prevented switching between databases
- Fixed a crash when downloading playlists (Git 485)
- When a channel is marked for downloading (by selecting the checkbox next to
a channel's name), and the channel is then deleted, the text of the buttons
in the bottom-left corner of the Videos tab was not updated correctly.
Fixed
- Due to an unresolved issue, in some situations Tartube generates the errors
'Cannot remove row in Progress List' or 'Missing row in Progress List'.
A very large number of these errors could be produced by a single video.
Tweaked the code, so the error is seen only once (Git 479)
- Fixed a Python error when dragging and dropping videos from Firefox into
Tartube's main window

MINOR FIXES
- Tweaked detection of the file size for downloaded videos in some situations
in which it was not detected (Git 472)
- While checking/downloading videos, in the Progress tab's popup menus, fixed
the broken 'Download last' and 'Download next' items. Also fixed some
icons being to the wrong column (Git 480)
- Fixed inability to detect the system locale when Tartube is launched from a
text editor (in this case, Geany)
- The preferences window no longer shows 'English' as the selected locale if
the user has selected a different locale (French, for example), when
Tartube was unable to load the latter
- Added code to handle video thumbnails from VK, which frequently sends .jpeg
images mislabelled as .webp (Git 478)
- In the tidy operation window, the option to 'Delete all .webp thumbnails'
did not work. Fixed it
- When downloading from VK, Tartube was not able to produce a sorted playlist
that matched what a user would be expecting. Tweaked various bits of code
to improve the situation (Git 476 and others)
- Tooltips were still visible in the Video Index (left-hand side of the Videos
tab), even after they had been disabled in preferences. Fixed (Git 476)
- In the toolbar at the bottom of the Videos tab, the user was able to specify
all sorts of invalid values for the page size. Now, only page sizes of 1
or above can be specified. Because of technical issues, setting an
unlimited page size is not recommended, but you can use a very large value
like 9999 if you actually want many thousands of videos on one page
(Git 476)
- In the toolbar at the bottom of the Videos tab, changed the labels for the
'scroll up' and 'scroll down' buttons to 'scroll to top' and 'scroll to
bottom', which is what the buttons actually do
- On MS Windows, after selecting 'System > Open MSYS2 terminal', a dialogue
window with important information appears, but below the terminal window
itself. Swapped their positions so the user sees the important information
first
- In the download options window, Files > Filesystem, the text for the
'--no-mtime' option incorrectly read 'Use the server's file modification
time' instead of 'Don't use...'. Fixed (Git 488)
- For channel/playlist/folders with names about 45 characters long, tiles on
the grid in the Videos tab were sometimes partially outside the visible
window. Slightly decreased the maximum length of the name displayed, which
should resolve the problem in most cases
- Removed some <i> tags which were visible in the Videos tab, for certain
viewing modes

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

MAJOR NEW FEATURES
- Added a new tutorial. For new installations, it can be launched from the
setup window. For all users, it can be launched from Tartube's menu
(About > Show tutorial)
- MS Windows users can now select a dark theme for Tartube windows. In
Tartube's menu, click 'System > Change theme...'. Advanced users may be
able to install additional themes; see the README for more details. Thanks
to Rukongai for finding the solution (Git 355)
- Channels, playlists and folders can now have non-unique names; for example
you can have separate channels, both called 'Season 1', inside different
folders. However, you can't have two channels with the same name inside
the same folder (Git 439)
- Download options can now be applied directly to more than one channel,
playlist or folder (Git 464)
- Tartube has been re-licensed under LGPL 2.1

MINOR NEW FEATURES
- New translations available: French, Russian, Spanish and Vietnamese. Thanks
to everyone at Weblate who contributed to them, including Le Sharkoïste,
Tim Dewey, Equi and Zeref. In this release, your system's locale should be
applied automatically (no more messing around in the preferences window)
- Python errors, which until now were hidden in a terminal window (and
therefore not visible to must users), are now redirected to Tartube's
Errors/Warnings tab where everyone can see them
- In download options, Post-processing > General, the audio quality of the
post-processed audio file can now be set as a specific bitrate (e.g. 320
kb/s), as well as the 'high', 'medium' and 'low' settings that were already
available (Git 462)

MAJOR FIXES
- In the system preferences window, 'Downloaders' tab, tightened up the
behaviour of the buttons, entries and comboboxes so that the user cannot
specify contradictory settings or enter invalid values. On MS Windows, the
'Use custom path' setting is now marked as 'not recommended', because
Tartube code assumes that all users are using the official Tartube
installer. (It it apparently possible to install Tartube using WSL2, but
the authors have not been able to confirm that, so for the moment WSL2
installations are not 'officially' supported) (Git 466)
- Fixed errors in the file-tidying operation (from Tartube's menu, Operations >
Tidy up files) (Git 423, 463)
- .webp thumbnail images cannot be displayed in Tartube's window (because the
Gtk graphics libraries do not support them). By default, .webp thumbnails
are converted to .jpg (which are supported), but in some circumstances this
prevents users from embedding thumbnails into their videos. In this
version, when .webp thumbnails are converted to .jpg, the original .webp
files are not deleted (and so they are still available for embedding). You
can change this behaviour in Edit > System preferences... > Operations >
Downloads. You can use 'Operations > Tidy up files...' to remove multiple
.webp files at a later date, if you want to (Git 461)
- Drag and drop into the 'Add new videos' window did not work as intended, if
videos were dropped directly onto the textview. Specifically, a newline
character was not inserted between existing and new URLs. This issue also
affected several similar windows, but is now fixed
- When videos were downloaded as audio files (e.g. .m4a) and then converted to
another type of audio file (e.g. .mp3), Tartube's database was not updated
correctly. Due to some invisible magic in the operating system, most users
did not notice any problems, but some did. Fixed the issue, so that new
downloads will update the database correctly (Git 451)

MINOR FIXES
- In download options, Files > Filesystem, the 'Download all videos into this
folder' has been fixed so that it works correctly in non-English locales
- Fixed drag-and-drop into the 'Media' tab of the 'Scheduled download' window
- In the 'Add many channels/playlists' windows, names and URLs in the box at
the bottom were supposed to be editable, but were not. Fixed
- Fixed a rare problem for videos that were marked to be watched as soon as
they are downloaded, in which it was possible (in principle) to delete the
video before the media player was launched, causing numerous problems
- After fetching a list of video formats/subtitles, the dialogue window's
button opened the download options window at the wrong tab. Fixed
- In the Drag and Drop tab, code did not impede the user's attempts to delete
the 'general' (default) set of download options (which cannot be deleted).
Fixed
- Some youtube-dl commands surround download options with double quotes "...".
For technical reasons, these must be removed before Tartube can start a
youtube-dl download. Users were confused that the double quotes they had
specified were not visible in the Output tab; they are now visible there
(and also in the terminal window, when that is enabled) (Reddit)
- The preferences window, when opened, will now auto-fix any problems with sets
of download options in the Tartube database. This is a temporary patch for
an unresolved issue. The authors suspect the unresolved issue has
resolved itself, given that code handling applied download options has been
completely re-written for this release (Git 456)

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

MAJOR NEW FEATURES
- In the menu button in the top-right corner of the Classic Mode tab, there is
a new 'Enable one-click downloads' setting. Any valid URLs copied into the
box are downloaded automatically (or added to the existing download)
- Unlisted videos, which youtube-dl can't normally detecT, can now be inserted
into a channel. Right-click the channel and select 'Channel actions >
Insert videos...'. In order to check or download these unlisted videos,
you should either select them, right-click and choose 'Download videos'; or
alternatively, set up custom downloads to download each video individually
(Git 445)

MINOR NEW FEATURES
- In the preferences window, Operations > Livestreams, you can now block all
livestreams from being checked/downloaded. This only works when yt-dlp is
the downloader (Reddit thread)
- In the download options window, you can now use the option '--playlist-items'
(Git 438)
- In the setup wizard window, the text of the 'Install FFmpeg' button now
changes to 'Re-install FFmpeg' after the first installation attempt,
successful or not (for clarity). Both the download and install sizes are
now visible
- Tartube translations can now be prepared using Weblate. See
https://hosted.weblate.org/projects/tartube/ (Git #428)

MAJOR FIXES
- Updated to latest version of MSYS2, with which FFmpeg can be installed
correctly (Git 371, 444)

MINOR FIXES
- Fixed rare Python errors after right-clicking videos in the Progress List
and selecting 'Stop now', 'Stop after this video', etc

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

MAJOR FIXES
- In the download options window, the "Completely reset all download options to
their default values" button caused problems with the Drag and Drop tab,
which in turn prevented Tartube from finishing loading a database. Fixed,
and added some safeguards that would make a similar bug easier to detect,
if it were to happen again (Git 436)
- Fixed broken check buttons in the preferences window which could prevent it
from opening (Git 435)

MINOR FIXES
- In the Video Catalogue (in grid mode), adjusted the maximum length of the
channel/playlist/folder name to prevent the right-hand column being only
partially visible, under certain circumstances (Git 433)

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

MAJOR NEW FEATURES
- In the Videos tab, you can mark one or more channels/playlists/folders to
be downloaded by clicking the checkbuttons next to their names. Tartube can
now remember which items have been marked, storing them in a profile: in
the main menu, click Media > Profiles > Create profile. You can create as
many profiles as you like, and switch between them whenever you like. See
the README for more information (Git 409)
- During a download, you can now right-click a channel, playlist or folder to
add it to the download; previously, the menu item was greyed out (Git 430)

MINOR NEW FEATURES
- During Tartube installation, the user is now prompted to choose how often
their database file should be backed up. The default setting has also been
changed to 'every time' (Git 427)
- When the user deletes videos, they will now see a prompt asking for
confirmation. The user can choose between removing the video from the
database, and deleting the video from the filesystem completely. A
comparable prompt already appeared when deleting channels, playlists and
folders. In all cases, there is now an 'Always show this window' button
which can be de-selected, if convenient (Git 427)
- The dropdown box in the 'Add channel' window has been improved to add an
explicit item for 'No parent folder', instead of using an empty space. The
windows for adding playlists and folders have been updated in the same way.
The 'Add video' window has been tweaked to show icons inside the dropdown
box, as the other three windows already do
- In each video's properties window, there is a new button which updates the
video's data from its metadata file. Also, when the video's file path is
changed (manually by the user), the corresponding metadata is now
automatically loaded, updating the video in Tartube's database (Git 414)
- You can update multiple videos from their metadata by right-clicking them
and selecting Special > Reload metadata (Git 420)
- The detail of some icons were difficult to make out. They have been replaced
with sharper icons
- The list of videos in the Videos tab shows each video's name (which we call a
'nickname'), which is not necessarily identical to the video's file name.
You can now switch to displaying video file names instead: Edit >
System preferences... > Windows > Videos > Show nicknames (not video file
names) (Git 417)
- Tidied up the layout of the popup menu for videos
- In the download options window, in the Files > File names tab, you can now
set an output template with a date/time in several different formats
(Git 424)
- In the same window, added new options for '--live-from-start' and
'--wait-for-video' (Git 431, yt-dlp only)

MAJOR FIXES
- In the Videos tab toolbar, when the 'Show downloaded' button is toggled and,
as a result, no videos are visible, many of the toolbar icons were greyed
out. Fixed (Git 410)
- The video's edit window was unable to open under certain circumstances. Fixed
- In a separate issue, the video's edit window was unable to open when the
video didn't have a file associated with it. Fixed (Git 421/422)
- The list of custom downloads in Tartube's main menu (Operations >
Custom download all) was not updated when profiles were added or removed;
the list could only be updated by restarting Tartube. Fixed
- In the channel/playlist properties window, in the Associated Playlists tab,
the 'Add all playlists' button was broken. Fixed it

MINOR FIXES
- When setting a custom redirect for Invidious, Tartube added an initial 'www.'
which does not always resolve to a valid web address. This no longer
happens. Text in the preferences window (Operations > Mirrors) has been
updated to reflect this change (Git 412)
- Fixed an error in the code that resets channel/playlist/folder markers
(selection buttons) in the Video Index
- During a refresh operation, a video's URL, ID and duration were not set, if
they had not already been set (Git 414)
- When closing a video's properties window, the list of videos in the Video tab
was not properly updated when a filter was applied. Fixed (Git 413)
- In a video's properties window, in the General tab, when the video file is
changed, the entry boxes at the top of the window were not updated. Fixed
(Git 420)
- In the Drag and Drop tab, two icons of different sizes were used beside each
other; this has been fixed
- Fixed missing apostrophes (Git 411 and 416), and typos in the download
options window (Git 418)
- Tweaked the detection of invalid URLs, for example in the 'Add channel'
window
- In the download options window, in the Name tab, fixed inconsistent widget
layout when switching between simple and advanced options