Tartube

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

MAJOR NEW FEATURES
- Tartube now creates an icon in the user's system tray. Closing the main
window now closes to the tray, by default. To disable this behaviour,
click Edit > System preferences > Windows > Deselect 'Close to the tray...'
- When that functionality is enabled, Tartube can be shutdown by clicking
File > Quit. Scheduled download operations will still take place if Tartube
has been closed to the tray. Implements Github issue 37
- Tartube can now show a desktop notification at the end of a download
operation, rather that a dialogue window. This does not work on MS Windows.
On other operating systems, enable desktop notifications by clicking
Edit > System preferences... > Operations > Show a desktop notification...
- When you click the 'Add new video(s)' button, the folder displayed in the
dialogue window is now the same folder that's selected in the main window
(if any). The same applies for adding channels, playlists and folders.
Fixes Github issue 36
- If you normally use the 'Check all' button rather than the 'Download all'
button, and if you want to download a temporary copy of one of the videos,
there's now an easier way to do it. In the Videos tab, right-click the
video, and select 'Temporary > Download' or 'Temporary > Download and
Watch'. A copy of the video is downloaded into the 'Temporary Videos'
folder, without affecting any other folders

MINOR NEW FEATURES
- The icons for channels and playlists have been replaced, to make it easier to
tell them apart. Some other icons have been replaced too
- Videos can now be dragged and dropped from a web browser (or similar
application) into Tartube's main window, which automatically adds the video
to the currently selected folder (or 'Unsorted Videos', if no folder is
selected). Unfortunately, the code is not yet working reliably. We are
looking for a solution (Github issue 35)
- The layout of the Format tab in the download options window has been improved
to alleviate confusion experienced by users trying to download a video to
a sound format such as .mp3 (only). See the new section in the README file
- A number of new video/audio formats have been added, for example several new
60fps formats, implementing Github issue 40
- When you apply download options to a video/channel/playlist/folder, the
options are now cloned from the default set of options (those visible in
Edit > General download options...). To disable this behaviour, click
Edit > System preferences... > Operations > When applying download options,
automatically clone general download options. Implements Github issue 39
- The options already applied to a video/channel/playlist/folder can now be
reset to match the general options, any time you want. Use the new button
at the bottom of the download options window, in the General tab

MAJOR FIXES
- Fixed a rare crash when the video's JSON filename was too long for the
operating system
- In the download options window, Formats tab, the user can add up to three
video formats. The third format, if added, was always ignored. Fixed

MINOR FIXES
- If you perform a refresh operation on a folder, the operation now applies to
all videos, channels, playlists and folders inside it
- After adding a video to the folder that's currently selected, the video does
not appear immediately in the video catalogue. Fixed
- In the Progress and Errors/Warnings tabs, the column headers scrolled away
along with the rest of the list. Fixed; they are now always visible
- Video nicknames were not set correctly after an update operation. Fixed
- During a refresh operation, a video's name was compared against the full
filepath (filename and extension), which produced none of the intended
matches. Fixed
- The edit/preference windows had a tendency to increase in size without
limits. Fixed
- A video's annotations.xml file was not deleted correctly, when required.
Fixed
- In the download options window, the option 'hls-prefer-ffmpeg' is now working
correctly
- In the download options window, the 'prefer avconv over ffmpeg' options have
been desensitised on MS Windows, as there is no known method of using
Tartube with avconv on MS Windows
- youtube-dl creates a file, ytdl-archive.txt, recording all the videos that
it has downloaded. This can interfere if the user tries to re-download the
video(s) for any reason. Create of the ytdl-archive.txt file can now be
disabled (Edit > System preferences... > youtube-dl > Deselect 'Allow
youtube-dl to create its own archive...')
- If creation of the archive file is nonetheless enabled, Tartube can now
re-download video(s) without problems
- In rare circumstances, Tartube was unable to redraw the video catalogue
(the right-hand side of the Videos tab). Fxied

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

MAJOR FIXES
- v1.3.007 was completely broken when replacing an earlier installation. Fixed
- When Tartube's data directory was copied from one place to another (for
example, from one external drive to another), Tartube did not adapt to the
change very well. The way file paths are stored in Tartube's database has
been changed to eliminate this problem

MINOR FIXES
- Fixed an invalid time value which (sometimes) prevented a refresh operation
from completing correctly

-------------------------------------------------------------------------------
MAJOR NEW FEATURES
- Tartube on MS Windows did not recognise FFmpeg or AVConv. You can now tell
Tartube to download and install a compatible version of FFmpeg from the
main menu (Operations > Install FFmpeg). Tartube still cannot recognise
the ordinary version of FFmpeg, and it still does not recognise AVConv at
all. It is unlikely that this situation can be remedied
- A new Output tab has been added, in which you can see what is happening
internally when you check or download videos, update youtube-dl, install
FFmpeg, or refresh the Tartube database. The amount of information shown
can be customised in the System preferences window. The information can
still be written to STDOUT/STDERR, if required
- For users on other operating systems, the system preferences window
displayed the wrong location of the FFmpeg/AVConv executable. This has now
been fixed
- There are now two simple ways to specify the video resolution you want to
download (for example, 1080p). You can use the download options window
(Edit > General download options... > Formats, and then choose a video
format like 'any format [1080p]'). You can also use the new spinbutton at
the bottom of the Progress tab. Both of these methods have the same effect,
so it's not necessary to use both of them. Tartube will download videos in
that resolution if possible, or in the next highest available resolution
otherwise
- The download options window has been simplified, with only the most useful
options visible. If you want to see the full range of options, open any
download options window, and in the General tab, click the new 'Show
advanced download options' button

MINOR NEW FEATURES
- By default, temporary folders are no longer emptied when Tartube shuts down,
but only when Tartube starts up. This means you can continue watching
temporary videos you've downloaded even after shutting down Tartube. If you
want temporary folders to be emptied on shutdown, as before, select Edit >
System preferences... > Videos > Empty temporary folders when Tartube shuts
down

MAJOR FIXES
- Tartube experienced a whole range of problems when downloading videos to a
hard drive that was running out of space. Tartube now checks the available
disk space before starting to download anything, and continues checking it
throughout the download process. You can specify how much disk space should
be available in the System Preferences window. If the hard drive, despite
your best efforts, actually does run out of space, Tartube is now much more
resilient (and can usually halt the download process, rather than
crashing). The amount of disk space available is now visible in the System
Preferences window
- Adding a channel/playlist/folder whose name included a slash, for example
'Adam/Eve's Channel', had unfortunate consequences, with Tartube creating
a directory (folder) at the wrong location. Slashes are now automatically
converted to hyphens, which solves the problem
- In Tartube's window, dragging a channel/playlist/folder to a new location in
the tree changes the hard drive, moving a directory (folder) to a new
location in the filesystem. If a directory (folder) with the same name
already existed at that location, an invisible error occurs. Tartube now
displays a visible error so the user can delete the duplicate directory
(folder) manually
- When refreshing the Tartube database (e.g. Operations > Refresh database),
the moviepy module freezes if it encounters a corrupted video file. We
can't fix the moviepy module, but the Tartube code has been made much more
resilient
- When refreshing the Tartube database, Tartube made bad decisions if it was
looking for a video called 'ymca.mp4', but found a video called
'ymca.webm'. This has been fixed
- Tartube is now able to detect if its data directory (into which videos are
downloaded) doesn't exist. Usually this is because an external hard drive
has not been mounted; the user is now warned about this, so they can mount
it
- On MS Windows, if the user has updated youtube-dl or installed FFmpeg,
Tartube no longer freezes on shutdown
- On MS Windows, Tartube was unable to open a video file in the system's
default media player, if the name contained an ampersand. Fixed

MINOR FIXES
- When deleting large channels/playlists/folders, sometimes not everything was
deleted, and the user had to delete the item a second time. This was due to
inconsistencies in the Tartube database, which have now been fixed
- Channels/playlists/folders beginning with a number, e.g. '5 Pewdiepie', were
supposed to be displayed in numerical order, rather than in strict
alphabetical order. This did not work as intended (e.g. '11 Pewdiepie' was
listed before '1 T-Series'). Fixed again
- In the 'Delete channel' dialogue window (and so on), the name of the channel
to be deleted is now displayed prominently
- The size of the MS Windows installer has been reduced by about 40%

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

MINOR NEW FEATURES
- Tartube now ignores the YouTube 'WARNING: video doesn't have subtitles'
by default. You can change this setting, if you want to

MAJOR FIXES
- When moving a channel/playlist/folder to a different place on your
filesystem, or when renaming a channel/playlist/folder, in certain rare
situations data in the Tartube database isn't updated correctly. This may
lead to a freeze or a crash. I'm not sure yet what the cause is, but I have
added temporary code to prevent the problem affecting any user
- Fixed error messages generated when checking/downloading individual
channels/playlists/folders
- Fixed faulty code for importing videos/channels/playlists/folders into the
database

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

MAJOR NEW FEATURES
- Multiple channels, playlists and/or folders can now download their videos to
a single location. The README.rst file explains how it works, and why you
might want to do it
- You can also tell Tartube to download all videos into the 'Unsorted Videos'
or 'Temporary Videos' folders, instead of downloading them into separate
directories/folders for each channel and playlist
- Added automatic deletion of videos, disabled by default. Before enabling it,
you should do a 'Check all' or 'Download all' operation, which will create
the necessary youtube-dl archive files
- Added archiving. A video, channel, playlist or folder that is marked
archived won't be auto-deleted (but can still be deleted manually by the
user)
- You can now disable both checking and downloading a channel, playlist or
folder, if you want to. (It was already possible to just disabled
downloading them)
- Download operations can now be scheduled to take place at regular intervals
- You can now 'Download and watch' a video. The video is opened in your
system's default media player as soon as it has been downloaded
- Tartube can now download a video's annotations file automatically. Warnings
generated by YouTube about the lack of annotations are ignored by default
- For channels/playlists/folders containing many videos, you can now skip to
the first video uploaded after a certain date, using the new button in the
toolbar at the bottom of the Videos tab
- The lists in the Results tab can now be right-clicked, so you can change the
order in which videos/channels/playlists/folders are checked/downloaded,
abandon a download, play a video directly from the Results List, delete a
video directly from the Results List, and so on
- The edit window for youtube-dl options has been improved, adding many new
options to the GUI interface
- Plain text exports of Tartube's database can now be re-imported. Some
inconsistencies with the import process (from JSON and plain text files)
have been fixed

MINOR NEW FEATURES
- Added tooltips in several places. If you don't want to see tooltips above
videos/channels/playlists/folders, you can turn them off
- You can now select multiple videos in the Video Catalogue, and apply an
action to all of them (by right-clicking them)
- You can now switch to smaller icons in the Video Index (on the left side of
the Videos tab), if you want to
- You can now force the Video Index to expand its tree whenever you click on a
folder, revealing any channels/playlists it contains. This is disabled by
default
- If you only want to check videos, and never download them, you can disable
the 'Download all' buttons. Individual videos/channels/playlists/folders
can still be downloaded by right-clicking them
- Tartube's file structure has changed. If you run it from the command line,
you might need to use a (slightly) different command. See the README.rst
for details of what command to use
- The path to the FFmpeg/AVConv executable can now be specified by the user.
This will be especially helpful for MS Windows users
- Columns in the Progress tab can now be manually resized
- The Tartube website can now be opened from the main window menu
- XDG has been added as an optional dependency, for the benefit of Debian
packagers

MAJOR FIXES
- The MS Windows installer should now work for everyone
- Refresh operations are now stable (should not crash) on systems with Gtk 3.22
or earlier
- When downloads were disabled for a folder, downloads for channels/playlists/
folders inside that folder were still enabled. This is counter-intuitive,
so disabling downloads for a folder disables downloads for everything it
contains
- Marking/unmarking a video as favourite caused certain problems, which should
now be fixed

MINOR FIXES
- Fixed some unicode errors in reading JSON and plain text files
- Fixed the wrong page size displayed in the toolbar at the bototm of the
Videos tab
- Empty lines in a video's description are now preserved when they're displayed
in Tartube's main window

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

MAJOR NEW FEATURES
- You can now create an export of Tartube's database. This export contains
details of videos, channels, playlists and/or folders, but not the videos
themselves (or any of the thumbnail/description/metadata files). The
export can take two forms: JSON data, or plain text. If JSON data, the
exported file can later be imported into another Tartube database (imports
from plain text are not implemented yet). You can export either the
entire database, or just one channel/playlist/folder (and everythng it
contains)
- You can now change the name of a channel, playlist of folder. This doesn't
have any effect on your filesystem; it only changes the name displayed in
the Video Index (the left-hand side of the Videos tab). This might be
useful for channels and playlists that have weird or very short names. For
example, right-click a folder and select 'Folder actions > Set nickname...'
- You can also rename the channel, playlist or folder, and this action DOES
affect the filesystem, changing the directory/folder on your hard drive
where the channel/playlist/folder videos are stored. For example, right-
click a folder and select 'Filesystem > Rename location...'
- If you change the format of a downloaded video file from the default 'Title'
to, for example, 'Title + ID', the Video catalogue (the right-hand side of
the Videos tab) will now simply display the video's title (which should be
easier to read). To see the actual filename, you can right-click the video
and select 'Show properties'. This only works if the video's metadata was
downloaded when the video itself was downloaded; this is now turned on by
default for all new users

MINOR NEW FEATURES
- When adding videos, channels and playlists, the contents of the system's
clipboard was automatically copied into the window. This can now be turned
off, if you wish (Edit > System preferences... > Windows > When adding
videos/channels/playlists, copy URLs from the system clipboard)
- When adding channels/playlists, you can set the dialogue window to stay open,
which makes adding multiple channels/playlists quicker (Edit >
System preferences... > Windows > When adding channels/playlists, keep the
dialogue window open)
- When creating channels/playlists/folders inside an existing parent folder, a
dialogue window which stays open can be told to continuously re-use that
parent folder (Edit > System preferences... > Windows > When adding
channels/playlists, re-use the optional parent folder)
- When checking/downloading videos, the Results List (the bottom half of the
Progress tab) can now display videos in reverse order, so you don't have to
scroll down to see the video that was just checked/downloaded (Edit >
System Preferences... > Windows > Show results in reverse order)
- The number of ystem error and warning messages displayed in their own tab
is visible in the tab's label. The label is usually reset when the tab
is made visible. You can now disable this behaviour, preserving the numbers
until the 'Clear the list' button is explicitly clicked (Edit >
System preferences... > Windows > Don't remove number of system messages
from tab label until 'Clear' button is clicked)
- Items in the Video Index (on the left-hand side of the Videos tab) are sorted
alphabetically. The sorting algorithm has been improved to take account of
numbered items, such that '1 Music' will now appear before '11 Comedy'
- For the benefit of package maintainers (such as a Debian package), Tartube
now uses an environment variable which will prevent Tartube from updating
the youtube-dl binary, if specified. See the comments in setup.py

MAJOR FIXES
- Users whose system Gtk is earlier than v3.24 (this includes many current
Linux distros, but the MS Windows installer) will have experienced graphics
issues, and endless error messages in the terminal window, if open. If your
system Gtk is earlier than v3.24, Tartube will no longer update the Video
Index during a download operation; this should fix the issue at the cost of
disabling real-time updates of the number of videos in each channel,
playlist and folder. Your system's Gtk version is now visible in Tartube's
System Preferences window
- After loading the config file, the download limits were set, but not
displayed in the Progress tab. Fixed
- Rarely, Tartube crashes (or freezes) when loading a video's JSON metadata
file from your filesystem (but now when downloading it). This should no
longer happen

MINOR FIXES
- The 'Channel properties', 'Folder properties' (etc) windows used the wrong
icon (displaying a folder in the wrong colour). Fixed
- Fixed a 'list modified during sort' error during a download operation