Tartube

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

MAJOR NEW FEATURES
- Added (simplified) Chinese translation. Thanks to archblue
- Tartube's handling of video clips and video slices has been completely
rewritten, adding many new capabilities, and fixing some bugs. Clips and
sliced videos can now be created in both the Videos tab and the Classic
Mode tab. Support for yt-dlp's own clipping/slicing capabilities has been
added. For more information on the new features, see the README
(Git 523)
- You can now download videos, one at a time, specifying the name of each
downloaded file. This name overrides the name created by download options;
the new feature should be more convenient than updating download options
for each video you want to download. In the Videos tab, right-click a video
and select Special > Download with name... (Git 520)
- The system preferences window (Edit > System preferences...) now hides some
tabs and settings; they are revealed when you click the 'Show advanced
preferences' button. The behaviour is now exactly like the behaviour of the
download options and FFmpeg options windows

MINOR NEW FEATURES
- Drag-and-drop from Tartube's Errors/Warnings tab into another application
(such as a text editor) has been improved, so that the data transferred
can be customised (as is already the case for drag-and-drop from other
parts of Tartube's main window). To customise the settings, click
Edit > System preferences... > Windows > Drag
- Output generated by youtube-dl can now be written to a logfile, ytdl-log.log
(as well as to the Output tab and/or terminal window). This feature is
disabled by default; to enable it, see the settings in Edit >
System preferences ... > Output > Downloader log
- In the box at the bottom of the Classic Mode tab, you can now right-click a
line and select 'Re-insert URL above', which will move the URL back to the
box at the top of the tab (Git 532)
- In properties windows for videos, channels, playlists and folders, the
'Listed as' box is now editable. The text of this box is the text visible
in the Videos tab; changing it does not change the names of any files on
your filesystem. (The so-called nickname could already be changed in popup
menus.) (Git 520)
- Tweaked the American English 'translation' file to remove a load of pesky
British spellings

MAJOR FIXES
- When text containing URLs is copy/pasted into some boxes (for example, the
'Add new videos' dialogue window), Tartube did not cope well with multiple
URLs on the same line, or a valid URL followed by other text. Updated the
code to handle these situations better (Git 517)
- When the user's system locale is en_MY (or any other Anglophone locale,
besides en_GB and en_US), Tartube mishandles the locale, generating python
errors. Fixed (Git 518)
- Fixed python errors generated when deleting multiple videos in a playlist
(Git 521)
- Tartube should be able to respond to a livestream that has just started
broadcasting (for example, by playing an audio alarm, or by starting to
download it). This did not work in all possible situations; fixed
(Git 536)
- Fixed error in the installation file (setup.py) that installed sound files
to the wrong location, rendering them unavailable (Git 529)

MINOR FIXES
- The download statistics visible in the Progress tab (and added in the
previous release) are now also visible in the 'Download operation complete'
dialogue (Git 516)
- When creating a playlist inside a folder, which was itself inside a folder,
the playlist was added to the top level of the tree instead. Fixed
(Git 522)

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

MAJOR FIXES
- The previous version added code to intercept an unresolved Gtk issue, which
the user will see as a message in the Errors/Warnings tab,
'271: Cannot remove row in Progress List (row does not exist)'. The new
code itself caused a crash, when activated. The crash is fixed, the Gtk
issue remains unresolved
- During a download, error and warnings messages which could not be attached to
a particular video, and which were therefore attached to the parent channel
or playlist, were not visible in the Errors/Warnings tab. This bug has been
present since v2.3.471, so you may notice a dramatic increase in the number
of errors/warnings visible in the tab

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

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