Update to v2.4.221

.github/ISSUE_TEMPLATE/ask_question.md

@@ -1,16 +1,12 @@
 ---
-name: "Ask Question \U0001F4A1"
+name: Ask Question 💡
 about: Ask a Tartube related question
-title: ''
 labels: question
-assignees: ''
-
 ---
-
 Thanks for taking the time to ask a question! 
 
 ### Please read the README
 Perhaps your question is answered there
 
 ### The authors are not experts in python, security, youtube-dl, FFmpeg, Debian/RPM packaging or Windows programming
-You are welcome to ask a Tartube-related question, but you might get a better answer in forums where those kinds of expert can be found
+You are welcome to ask a Tartube-related question, but you might get a better answer in forums where those kinds of expert can be found

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,12 +1,10 @@
 ---
-name: "Bug report \U0001F41E"
+name: Bug report 🐞
 about: Create a report to help us improve
 title: ''
 labels: bug
 assignees: ''
-
 ---
-
 Thanks for taking the time to submit a bug report! Please include the following information:
 
 ### What operating system are you using?
@@ -15,6 +13,19 @@ If using MS Windows, are you using Windows 10, Windows 7, or something else?
 ### What version of Tartube are you using?
 In Tartube's main window, click Help > About
 
-### What do you see in the Errors/Warnings tab?
+### What happens when you run Tartube from a terminal window?
+Many error messages are only visible in the terminal window. On MS Windows, this is how to do it:
+
+- First, enable hidden folders on your system
+- Then, run the application: 
+
+    C:\Users\YOURNAME\AppData\Local\Tartube\msys64\mingw64.exe
+
+- In this new window, type these commands to start Tartube:
+
+    cd /home/user/tartube
+
+    python3 tartube/tartube
 
-### If your bug report is "I can't download this video", please provide a link to the video
+###If your bug report is "I can't download this video", please provide a link to the video
+This will save a lot of time!

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,16 +1,13 @@
 ---
-name: "Feature Request \U0001F4A1"
+name: Feature Request 💡
 about: Suggest a new idea for the project.
-title: ''
 labels: enhancement
-assignees: ''
-
 ---
-
 Thanks for taking the time to submit a feature request! 
 
 ### Make sure you are using the most recent version of Tartube
 Perhaps your feature request has already been implemented. The most recent version can be downloaded from Github
 
 ### Please read the README
 Perhaps your feature request is already possible
+

AUTHORS

@@ -13,6 +13,8 @@ Russian: Tim Dewey,
     https://hosted.weblate.org/projects/tartube/language-names/ru/
 Spanish: Equi,
     https://hosted.weblate.org/projects/tartube/language-names/es/
+Turkish: PUFF1N,
+    https://hosted.weblate.org/projects/tartube/language-names/tr/
 Vietnamese: Zeref,
     https://hosted.weblate.org/projects/tartube/language-names/vi/
 
@@ -30,5 +32,5 @@ FFmpeg options adapted from FFmpeg Command Line Wizard by AndreKR
     https://github.com/AndreKR/ffmpeg-command-line-wizard
 Upgraded Textview by Kevin Mehall
     https://kevinmehall.net/2010/pygtk_multi_select_drag_drop
-Youtube Stream Capture by mrwnwttk
-    https://github.com/mrwnwttk
+XDG support by Scott Stevenson
+    https://pypi.org/project/xdg/

CHANGES

@@ -1,3 +1,114 @@
+v2.4.221 (9 Jan 2023)
+-------------------------------------------------------------------------------
+
+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
+
 v2.4.165 (24 Nov 2022)
 -------------------------------------------------------------------------------
 

README.rst

@@ -66,16 +66,16 @@ For a full list of new features and fixes, see `recent changes <CHANGES>`__.
 3 Downloads
 ===========
 
-Stable release: **v2.4.165 (24 Nov 2022)**
+Stable release: **v2.4.221 (9 Jan 2023)**
 
-Development release: **v2.4.201 (19 Dec 2022)**
+Development release: **v2.4.221 (9 Jan 2023)**
 
 Official packages (also available from the `Github release page <https://github.com/axcore/tartube/releases>`__):
 
-- `MS Windows (64-bit) installer <https://sourceforge.net/projects/tartube/files/v2.4.165/install-tartube-2.4.165-64bit.exe/download>`__ and `portable edition <https://sourceforge.net/projects/tartube/files/v2.4.165/tartube-2.4.165-64bit-portable.zip/download>`__ from Sourceforge
+- `MS Windows (64-bit) installer <https://sourceforge.net/projects/tartube/files/v2.4.221/install-tartube-2.4.221-64bit.exe/download>`__ and `portable edition <https://sourceforge.net/projects/tartube/files/v2.4.221/tartube-2.4.221-64bit-portable.zip/download>`__ from Sourceforge
 - Tartube is no longer supported on MS Windows (32-bit) - see `7.23 Doesn't work on 32-bit Windows`_
-- `DEB package (for Debian-based distros, e.g. Ubuntu, Linux Mint) <https://sourceforge.net/projects/tartube/files/v2.4.165/python3-tartube_2.4.165.deb/download>`__ from Sourceforge
-- `RPM package (for RHEL-based distros, e.g. Fedora) <https://sourceforge.net/projects/tartube/files/v2.4.165/tartube-2.4.165.rpm/download>`__ from Sourceforge
+- `DEB package (for Debian-based distros, e.g. Ubuntu, Linux Mint) <https://sourceforge.net/projects/tartube/files/v2.4.221/python3-tartube_2.4.221.deb/download>`__ from Sourceforge
+- `RPM package (for RHEL-based distros, e.g. Fedora) <https://sourceforge.net/projects/tartube/files/v2.4.221/tartube-2.4.221.rpm/download>`__ from Sourceforge
 
 Official 'Strict' packages:
 
@@ -92,7 +92,7 @@ Semi-official packages (Linux):
 
 Source code:
 
-- `Source code <https://sourceforge.net/projects/tartube/files/v2.4.165/tartube_v2.4.165.tar.gz/download>`__ from Sourceforge
+- `Source code <https://sourceforge.net/projects/tartube/files/v2.4.221/tartube_v2.4.221.tar.gz/download>`__ from Sourceforge
 - `Source code <https://github.com/axcore/tartube>`__ and `support <https://github.com/axcore/tartube/issues>`__ from GitHub
 - In case this Github repository is taken down, there is an official backup `here <https://gitlab.com/axcore/tartube>`__
 
@@ -491,13 +491,14 @@ The procedure used to create the MS Windows installer is described in full in th
 * `6.12.4 Setting download options`_
 * `6.13 Scheduled downloads`_
 * `6.14 Custom downloads`_
-* `6.14.1 Creating custom downloads`_
-* `6.14.2 Independent downloads`_
-* `6.14.3 Diverting to HookTube / Invidious`_
-* `6.14.4 Delays between downloads`_
-* `6.14.5 Splitting and slicing videos`_
-* `6.14.6 Ignoring videos without subtitles`_
-* `6.14.7 Launching custom downloads`_
+* `6.14.1 Default custom downloads`_
+* `6.14.2 Adding custom downloads`_
+* `6.14.3 Independent downloads`_
+* `6.14.4 Diverting to HookTube / Invidious`_
+* `6.14.5 Delays between downloads`_
+* `6.14.6 Splitting and slicing videos`_
+* `6.14.7 Ignoring videos without subtitles`_
+* `6.14.8 Launching custom downloads`_
 * `6.15 Watching videos`_
 * `6.16 Filtering and finding videos`_
 * `6.17 Marking videos`_
@@ -956,7 +957,7 @@ If you want to download subtiles only in particular languages:
 - Click the **Add language** button
 - Repeat for as many languages as you want
 
-See also `6.14.6 Ignoring videos without subtitles`_.
+See also `6.14.7 Ignoring videos without subtitles`_.
 
 6.13 Scheduled downloads
 ------------------------
@@ -999,27 +1000,36 @@ A **Custom download** enables you to modify this behaviour, if desired. You can
 
 It's important to note that a custom download behaves exactly like a regular download until you specify the new behaviour.
 
-6.14.1 Creating custom downloads
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+6.14.1 Default custom downloads
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-You can create as many different custom downloads as you like.
+By default, **Tartube** provides two custom downloads. 
 
-- Click **Edit > System preferences... > Operations > Custom**
-- In the **Name** box, type any name
-- Click the **Add** button
-- A new window opens, in which you can specify the new behaviour
+The custom download called **general** applies in the **Videos** tab. It is used, for example, when you right-click a channel and select **Custom download channel**.
 
-If you use custom downloads a lot, you can add some extra buttons to the **Videos** tab.
+If you use the **general** custom download a lot, you can add an extra button to the **Videos** tab.
 
 - Click **Edit > System preferences... > Windows > Videos**
 - Select the button **Show a 'Custom download all' button in the Videos tab**
 
 .. image:: screenshots/example20.png
   :alt: The option custom download button
 
-The **Custom download all** button starts the custom download called **general**. The button next to it opens a list of custom downloads. Select one, and that custom download will start.
+The custom download called **classic** applies in the **Classic Mode** tab. To enable it, right-click the menu button in the top-right corner of the tab, and select **Enable custom downloads**.
+
+6.14.2 Adding custom downloads
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In addition to the those, you can create as many new custom downloads as you want.
+
+- Click **Edit > System preferences... > Operations > Custom**
+- In the **Name** box, type any name
+- Click the **Add** button
+- A new window opens, in which you can specify the new behaviour
+
+Now, when you select a custom download in the **Videos** tab (for example, by right-clicking a channel and selecting **Custom download channel**, you'll be prompted to choose the custom download you want.
 
-6.14.2 Independent downloads
+6.14.3 Independent downloads
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 By default, **Tartube** instructs **youtube-dl** to download a channel or a playlist. **youtube-dl** only needs a link to the channel or playlist, so **Tartube** doesn't send it a link to every single video.
@@ -1033,7 +1043,7 @@ If you need to download each individual video, one URL at a time, you can do thi
 
 Many custom download settings only work when Tartube is downloading videos one at a time. If you enable this setting, you will be able to enable several other settings in the other tabs.
 
-6.14.3 Diverting to HookTube / Invidious
+6.14.4 Diverting to HookTube / Invidious
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If **Tartube** can't download a video from YouTube, it's sometimes possible to obtain it from an alternative website instead.
@@ -1048,7 +1058,7 @@ There are a number of alternative YouTube front-ends available, besides `HookTub
 
 When specifying an alternative website, it's very important that you type the *exact text* that replaces **youtube.com** in a video's URL. For example, you must type **hooktube.com**, not **www.hooktube.com** or **http://www.hooktube.com/**.
 
-6.14.4 Delays between downloads
+6.14.5 Delays between downloads
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If the video website is complaining that you're making too many requests (in other words, downloading too many videos too quickly), it's possible to add a delay betwen downloads. The delay can have a fixed or random duration.
@@ -1063,7 +1073,7 @@ If the video website is complaining that you're making too many requests (in oth
 
 The delay is applied after downloading a channel or a playlist. If you want to apply the delay after each video, you should enable individual video downloads as well (as described above).
 
-6.14.5 Splitting and slicing videos
+6.14.6 Splitting and slicing videos
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 During a custom download, you can automatically split a video into video clips *while it is being downloaded*. A list of clips can be grabbed from the video's description, or from its chapter list, or you can specify your own list of clips. For more information, see see `6.27 Video clips`_
@@ -1072,7 +1082,7 @@ You can also remove slices from a video *while it is being downloaded*. This is
 
 Both of these features require **FFmpeg**.
 
-6.14.6 Ignoring videos without subtitles
+6.14.7 Ignoring videos without subtitles
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 You can ask Tartube not to download videos without subtitles.
@@ -1093,7 +1103,7 @@ Note that this setting *reduces the number of videos downloaded*. It isn't respo
 
 **youtube-dl** handles YouTube live chat in the same way as subtitles, so you can select that instead of (or as well as) the languages.
 
-6.14.7 Launching custom downloads
+6.14.8 Launching custom downloads
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Besides the optional button described above, there are several ways to start a custom download.

VERSION

@@ -1 +1 @@
-2.4.201
+2.4.221