You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.rst
+31-53Lines changed: 31 additions & 53 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -37,45 +37,23 @@ Problems can be reported at `our GitHub page <https://github.com/axcore/tartube/
37
37
- **Tartube** can alert you when livestreams and debut videos are starting (works on **YouTube**, **Twitch** and **Odysee** by default)
38
38
- If creators upload their videos to more than one website (**YouTube** and **BitChute**, for example), **Tartube** can interact with both sites without creating duplicates
39
39
- Certain sites operate an "only one opinion allowed" policy. If you think that the censors will remove a video, against the wishes of its creators and before you've had a chance to watch it, **Tartube** can make an archive copy
40
-
- Certain sites frequently place restrictions on a video, not because it is unsuitable for some audiences, but for purely political reasons. Tartube can, in some circumstances, see videos that are region-blocked and/or age-restricted
41
40
- Certain sites manipulate search results, repeatedly unsubscribe people from their favourite channels and/or deliberately conceal videos that they don't like. **Tartube** won't do any of those things
42
41
- If you want to listen to your favourite discussion videos, for example while driving a car, **Tartube** can make an archive copy of just the audio, rather than the full video
43
42
- **Tartube** is free and open-source software
44
43
45
-
2.1 What's new in version 2.4.0
46
-
-------------------------------
47
-
48
-
- Videos can be downloaded as a set of video clips, and you can split an existing video into clips (requires **FFmpeg**, see `6.27 Video clips`_). **Tartube** will read timestamps from a video's description, or you can specify your own timestamps
49
-
- Added support for `SponsorBlock <https://streamlink.github.io/>`__. Videos can be downloaded with slices removed, or you can remove slices from an existing video (requires **FFmpeg**, see `6.28 Video slices`_)
50
-
- **Tartube** can extract video comments, and optionally store them in its database (requires **yt-dlp**, see `6.30 Video comments`_)
51
-
- **Tartube** now supports livestream downloads using `streamlink <https://streamlink.github.io/>`__ or with the video's .m3u manifest (see `6.24.4 Downloading livestreams`_). Support for the deprecated `Youtube Stream Capture <https://github.com/mrwnwttk/youtube_stream_capture>`__ has been removed
52
-
- Livestream detection now works on **Twitch** and **Odysee**, as well as on **YouTube**. Detection may work on other sites, after you have set the RSS feed (see `6.24.5 Compatible websites`_)
53
-
- The new **Recent videos** folder shows videos added to the database during the last check or download. Its modified can be customised, if you want, to show videos from today or the last few days
54
-
- Channels, playlists and folders can now be selected. The buttons in the bottom-left corner of the **Videos** tab will check or download just the selected items
55
-
- During a download, the **Videos** tab is now updated in real time, resolving an ancient problem with the Gtk library
56
-
- The toolbar at the bottom of the **Videos** tab has been overhauled. You can now search comments and video descriptions, as well as hide (un)downloaded videos
57
-
- The layout of the **Classic Mode** tab has been overhauled. You can now specify a resolution, as well as a video format
58
-
- The new **Drag and Drop** tab is a quick way to download videos in **.mp3** format. Every zone corresponds to a set of download options (see `6.12 Download options`_), so you can customise the tab in any way you like. Drag and Drop does not work well on MS Windows (this is not a **Tartube** issue)
59
-
- The **Errors/Warnings** tab is now fully searchable. Settings for that tab are now applied immediately, and are reversible
60
-
- Custom downloads have been overhauled. You can now create as many custom downloads as you like, using as many of the new settings as you like (see `6.14 Custom downloads`_)
61
-
- Channels and playlists in your database can now download videos to any location on your filesystem (see `6.18.5 Download all videos to an external folder`_)
62
-
- **Tartube** can now display statistics about the channels and playlists in your database, and the database as a whole (requires **matplotlib**; MS Windows users can install it from the main menu)
63
-
64
-
For a full list of new features and fixes, see `recent changes <CHANGES>`__.
65
-
66
44
3 Downloads
67
45
===========
68
46
69
-
Stable release: **v2.4.412 (31 Jul 2023)**
47
+
Stable release: **v2.4.429 (21 Nov 2023)**
70
48
71
-
Development release: **v2.4.416 (20 Sep 2023)**
49
+
Development release: **v2.4.429 (21 Nov 2023)**
72
50
73
51
Official packages (also available from the `Github release page <https://github.com/axcore/tartube/releases>`__):
74
52
75
-
- `MS Windows (64-bit) installer <https://sourceforge.net/projects/tartube/files/v2.4.412/install-tartube-2.4.412-64bit.exe/download>`__and `portable edition <https://sourceforge.net/projects/tartube/files/v2.4.412/tartube-2.4.412-64bit-portable.zip/download>`__ from Sourceforge
76
-
- Tartube is no longer supported on MS Windows (32-bit) - see `7.24 Doesn't work on 32-bit Windows`_
77
-
- `DEB package (for Debian-based distros, e.g. Ubuntu, Linux Mint) <https://sourceforge.net/projects/tartube/files/v2.4.412/python3-tartube_2.4.412.deb/download>`__ from Sourceforge
78
-
- `RPM package (for RHEL-based distros, e.g. Fedora) <https://sourceforge.net/projects/tartube/files/v2.4.412/tartube-2.4.412.rpm/download>`__ from Sourceforge
53
+
- `MS Windows (64-bit) installer <https://sourceforge.net/projects/tartube/files/v2.4.429/install-tartube-2.4.429-64bit.exe/download>`__, `MS Windows (64-bit) and FFmpeg installer <https://sourceforge.net/projects/tartube/files/v2.4.429/install-tartube-with-ffmpeg-2.4.429-64bit.exe/download>`__ and `portable edition <https://sourceforge.net/projects/tartube/files/v2.4.429/tartube-2.4.429-64bit-portable.zip/download>`__ from Sourceforge
54
+
- Tartube is no longer supported on older versions of MS Windows - see `7.24 Doesn't work on 32-bit Windows / Windows 7 / Windows 8`_
55
+
- `DEB package (for Debian-based distros, e.g. Ubuntu, Linux Mint) <https://sourceforge.net/projects/tartube/files/v2.4.429/python3-tartube_2.4.429.deb/download>`__ from Sourceforge
56
+
- `RPM package (for RHEL-based distros, e.g. Fedora) <https://sourceforge.net/projects/tartube/files/v2.4.429/tartube-2.4.429.rpm/download>`__ from Sourceforge
79
57
80
58
Official 'Strict' packages:
81
59
@@ -92,7 +70,7 @@ Semi-official packages (Linux):
92
70
93
71
Source code:
94
72
95
-
- `Source code <https://sourceforge.net/projects/tartube/files/v2.4.412/tartube_v2.4.412.tar.gz/download>`__ from Sourceforge
73
+
- `Source code <https://sourceforge.net/projects/tartube/files/v2.4.429/tartube_v2.4.429.tar.gz/download>`__ from Sourceforge
96
74
- `Source code <https://github.com/axcore/tartube>`__ and `support <https://github.com/axcore/tartube/issues>`__ from GitHub
97
75
- In case this Github repository is taken down, there is an official backup `here <https://gitlab.com/axcore/tartube>`__
98
76
@@ -136,7 +114,7 @@ There is also a portable edition; use this if you want to install **Tartube** on
136
114
137
115
Both the installer and the portable edition include a copy of `AtomicParsley <https://bitbucket.org/jonhedgerows/atomicparsley/wiki/Home>`__, so there is no need to install it yourself.
138
116
139
-
Tartube is no longer supported on MS Windows (32-bit) - see `7.24 Doesn't work on 32-bit Windows`_.
117
+
Tartube is no longer supported on MS Windows (32-bit) - see `7.24 Doesn't work on 32-bit Windows / Windows 7 / Windows 8`_.
140
118
141
119
5.1.1 Manual installation - MS Windows
142
120
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -345,7 +323,7 @@ If neither **youtube-dl** nor **pip** are installed on your system, then the rec
345
323
On Fedora, the procedure is:
346
324
347
325
1. Open a terminal window
348
-
2. Type: ``dnf -y install python3-pip``
326
+
2. Type: ``sudo dnf -y install python3-pip``
349
327
3. Type: ``pip3 install youtube-dl`` or ``pip3 install yt-dlp``
350
328
4. You can now run **Tartube**.
351
329
@@ -393,21 +371,23 @@ Here is the procedure for Debian-based distributions, like Ubuntu and Linux Mint
393
371
394
372
1. Make sure **youtube-dl** has been completely removed from your system
395
373
2. Type: ``sudo apt install python3-pip``
396
-
3. Type: ``sudo pip3 install youtube-dl tartube``, or type ``sudo pip3 install yt-dlp tartube``
397
-
4. Type: ``tartube``
374
+
3. ...but on Fedora, type: ``sudo dnf -y install python3-pip``
375
+
4. Type: ``sudo pip3 install youtube-dl tartube``, or type ``sudo pip3 install yt-dlp tartube``
376
+
5. Type: ``tartube``
398
377
399
378
5.3.7 Install using PyPI (without root privileges)
3. The **Tartube** executable is stored in ``~/.local/bin`` by default. If that is already in your path, you can start **Tartube** by typing ``tartube``. Otherwise, type ``~/.local/bin/tartube``
405
-
4. **Tartube** asks you to choose a data directory, so do that
406
-
5. In the **Tartube** main window, click **Edit > System preferences... > youtube-dl**
407
-
6. In the box marked **Path to youtube-dl executable**, select **Use PyPI path (\~/.local/bin/youtube-dl)**
408
-
7. Click **OK** to close the dialogue window
409
-
8. Click **Operations > Update youtube-dl**
410
-
9. Once the update has finished, **Tartube** is ready for use
382
+
2. ...but on Fedora, type: ``sudo dnf -y install python3-pip``
383
+
3. Type: ``pip3 install tartube``
384
+
4. The **Tartube** executable is stored in ``~/.local/bin`` by default. If that is already in your path, you can start **Tartube** by typing ``tartube``. Otherwise, type ``~/.local/bin/tartube``
385
+
5. **Tartube** asks you to choose a data directory, so do that
386
+
6. In the **Tartube** main window, click **Edit > System preferences... > youtube-dl**
387
+
7. In the box marked **Path to youtube-dl executable**, select **Use PyPI path (\~/.local/bin/youtube-dl)**
388
+
8. Click **OK** to close the dialogue window
389
+
9. Click **Operations > Update youtube-dl**
390
+
10. Once the update has finished, **Tartube** is ready for use
411
391
412
392
5.3.8 Manual installation
413
393
~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -2072,7 +2052,7 @@ You can now set the theme from Tartube's menu.
2072
2052
* `7.21 Video website blocks me`_
2073
2053
* `7.22 Too many blocked videos`_
2074
2054
* `7.23 MS Windows installer is too big`_
2075
-
* `7.24 Doesn't work on 32-bit Windows`_
2055
+
* `7.24 Doesn't work on 32-bit Windows / Windows 7 / Windows 8`_
2076
2056
* `7.25 Tartube can't detect livestreams`_
2077
2057
* `7.26 Livestream is already finished`_
2078
2058
* `7.27 Can't hear livestream alarms`_
@@ -2094,11 +2074,11 @@ You can now set the theme from Tartube's menu.
2094
2074
2095
2075
*Q: I can't install Tartube / I can't run Tartube / Tartube doesn't work properly!*
2096
2076
2097
-
A: Tartube is known to fail on Windows 7 systems that have not been updated for some time. A possible solution is to install `this patch from Microsoft <https://www.microsoft.com/en-us/download/details.aspx?id=26767>`__. The simplest way to install the patch is to let Windows update itself, as normal.
2077
+
A: See `7.24 Doesn't work on 32-bit Windows / Windows 7 / Windows 8`_
2098
2078
2099
2079
A: See also `7.2 Update Tartube on MS Windows`_
2100
2080
2101
-
A: On Linux, if the DEB or RPM package doesn't work, try installing via PyPI.
2081
+
A: On Linux, if the DEB or RPM package doesn't work, try installing via PyPI: `5.3.5 Install using PyPI`_
2102
2082
2103
2083
A: Please report any problems to the authors at our `Github page <https://github.com/axcore/tartube/issues>`__.
2104
2084
@@ -2438,20 +2418,18 @@ The NSIS scripts used to create the installers can be found here:
2438
2418
2439
2419
The scripts contain full instructions, so you should be able to create your own installer and then compare it to the official one.
2440
2420
2441
-
7.24 Doesn't work on 32-bit Windows
2442
-
-----------------------------------
2443
-
2444
-
*Q: Tartube does not install/work on 32-bit Windows*
2421
+
7.24 Doesn't work on 32-bit Windows / Windows 7 / Windows 8
A: Cygwin and MSYS2 have `dropped support for 32-bit Windows <https://www.msys2.org/news/#2020-05-17-32-bit-msys2-no-longer-actively-supported>`__.
2424
+
*Q: Tartube does not install/work on my ancient computer!*
2447
2425
2448
-
Therefore there will be no further releases of Tartube for 32-bit Windows. Old installers will still work, and for a time it will still be possible to use them to install Tartube and youtube-dl. However, as of March 2022 it is already not possible to install FFmpeg.
2426
+
A: MSYS2 has dropped support for older Windows systems. As of November 2023, the minimum requirement is `64bit Windows 8.1 / Windows Server 2012 R2 <https://www.msys2.org/docs/windows_support/>`__.
2449
2427
2450
-
The final 32-bit releases (v2.3.367) can be downloaded from here:
2428
+
Tartube cannot be run on any 32-bit Windows system.
2451
2429
2452
-
`MS Windows (32-bit) installer <https://sourceforge.net/projects/tartube/files/v2.3.367/install-tartube-2.3.367-32bit.exe/download>`__
2430
+
Tartube can be run on Windows 7 and Windows 8, but you will need to use an `older installer <https://sourceforge.net/projects/tartube/files/v2.4.386/install-tartube-with-ffmpeg-2.4.386-64bit.exe/download>`__.
0 commit comments