Add files via upload

axcore · May 27, 2019 · d506f02 · d506f02
commit d506f02
Show file tree

Hide file tree

Showing 85 changed files with 22,434 additions and 0 deletions.
diff --git a/AUTHORS b/AUTHORS
@@ -0,0 +1,14 @@
+Lead developer:
+A S Lewis <[email protected]>
+
+Authors ordered by first contribution:
+(none yet)
+
+Image credits:
+Vectorgraphit <https://www.iconfinder.com/vectorgraphit>
+FatCow Web Hosting https://www.fatcow.com/>
+Mr. Hopnguyen <https://www.iconfinder.com/Mr.hopnguyen>
+
+Other credits:
+Tartube is partially based on youtube-dl-gui
+
diff --git a/CHANGES b/CHANGES
@@ -0,0 +1,5 @@
+v0.1.0 (27 May 2019)
+--------------------------------------------------------------------------------
+
+- This is the first public release of Tartube
+
diff --git a/LICENSE b/LICENSE
diff --git a/MANIFEST.in b/MANIFEST.in
@@ -0,0 +1 @@
+include LICENSE
diff --git a/Makefile b/Makefile
@@ -0,0 +1,5 @@
+init:
+	pip install -r requirements.txt
+
+test:
+	nosetests tests
diff --git a/README.md b/README.md
@@ -0,0 +1,174 @@
+#Tartube
+
+Tartube is a GUI front-end for [youtube-dl](https://youtube-dl.org/), partly based on [youtube-dl-gui](https://mrs0m30n3.github.io/youtube-dl-gui/) and written in Python 3 / Gtk 3.
+
+Tartube is the **alpha software**. It crashes a lot. If you find this frustrating, find a solution and then [send it to me](https://github.com/axcore/tartube/issues).
+
+##Why should I use Tartube?
+* You can download individual videos, and even whole channels and playlists, from hundreds of different websites
+* You can fetch information about those videos, channels and playlists, without actually downloading anything
+* Tartube will organise your videos into convenient folders
+* Certain popular video websites manipulate search results, repeatedly unsubscribe people from their favourite channels and/or deliberately conceal videos which challenge the Californian political consensus. Tartube won't do any of those things
+* Tartube can, in some circumstances, see videos that are region-blocked and age-restricted
+
+## Requirements
+
+* A working installation of [youtube-dl](https://youtube-dl.org/)
+* [Python 3+](https://www.python.org/downloads)
+* [Gtk 3+](https://python-gtk-3-tutorial.readthedocs.io/en/latest/)
+* [Python validators module](https://pypi.org/project/validators/) optional, but recommended
+* [Python moviepy module](https://pypi.org/project/moviepy/) optional
+
+##Downloads
+* [Source](http://tartube.sourceforge.io/) from sourceforge.io
+* [Source](https://github.com/axcore/tarbue) from github
+
+##Installation
+
+###Install from source
+1. Download & extract the source
+2. Change directory into the Tartube directory
+3. Run `python setup.py install`
+
+###Install using PyPI
+1. Run `pip install tartube`
+
+###Install using MS Windows Installer
+There is no installer for MS Windows yet.
+
+###Run without installing
+1. Download & extract the source
+2. Change directory into the Tartube directory
+3. Run 'python tartube.py'
+
+##Frequently-Asked Questions
+**Q: I can't install Tartube!**
+
+A: I have no experience of writing in Python and I'm still working it out for myself. Contact me on the [Github issues](https://github.com/axcore/tartube/issues) page if you can do better than me.
+
+**Q: I can't run Tartube!**
+
+A: See above.
+
+**Q: Tartube doesn't work properly!**
+
+A: See above.
+
+**Q: Tartube keeps crashing!**
+
+A: See above.
+
+**Q: How do I use Tartube?**
+
+A: Assuming that Tartube is installed and running correctly, then you should start by checking that youtube-dl is also installed and running correctly. 
+
+* Click **Operations > Update youtube-dl**
+
+There are several locations on your filesystem where youtube-dl might have been installed. If the update operation fails, you should try modifying Tartube's settings.
+
+* Click **Edit > System preferences...**
+* Click the **youtube-dl** tab
+* Try changing the setting **'Actual path to use during download/update/refresh operations'**
+* Try changing the setting **'Shell command for update operations'**
+* Try the update operation again
+
+On the left side of the Tartube window is a list of folders. You can store videos, channels and playlists inside these folders. You can even store folders inside of other folders.
+
+Tartube saves videos on your filesystem using exactly the same structure.
+
+When you start Tartube, there are five folders already visible. You can't remove any of these folders (but you can hide them, if you want).
+
+Videos saved to the 'Temporary Videos' folder are deleted when Tartube shuts down.
+
+Once you've finished adding videos, channels, playlists and folders, there are four things Tartube can do:  
+
+* **'Check'** - Fetch information about videos, but don't download them
+* **'Download'** - Actually download the videos. If you have disabled downloads for a particular item, Tartube will just fetch information about it instead
+* **'Update'** - Updates youtube-dl, as described above
+* **'Refresh'** - Examines your filesystem. If you have manually copied any videos into Tartube's data directory, those videos are added to Tartube's database
+
+**Protip:** Do an **'Update'** operation before you do a **'Check'** or **'Download'** operation
+
+**Protip:** Do a **'Check'** operation before you do **'Refresh'** operation
+
+youtube-dl offers a large number of download options. This is how to set them.
+
+* Click **Edit > General download options...**
+
+Any changes you make in the new window aren't actually applied until you click the **'Apply'** or **'OK'** buttons.
+
+Those are the *default* download options. If you want to apply a *different* set of download options to a particular channel or particular playlist, you can do so.
+
+For example, suppose you have added these folders and channels:
+
+        Comedy folder
+            CollegeHumor channel
+            PewDiePie channel
+        Politics folder
+            Liberal folder
+                The Young Turks channel
+            Conservative folder
+                Joe Rogan channel
+                Mark Dice channel
+
+The general download options apply to all of these channels. Now, suppose you apply some download options to the Politics folder:
+
+* Right-click the folder, and select **Apply download options...**
+
+Tartube's database now looks something like this:
+
+        Comedy folder
+            CollegeHumor channel
+            PewDiePie channel
+        ++Politics folder
+            Liberal folder
+                The Young Turks channel
+            Conservative folder
+                Joe Rogan channel
+                Mark Dice channel
+
+The new download options (marked ++) apply to *everything* inside the Politics folder - The Young Turks, Joe Rogan and Mark Dice.
+
+Now, suppose you add another set of download options  (marked @@) to the Conservative folder:
+
+        Comedy folder
+            CollegeHumor channel
+            PewDiePie channel
+        **Politics folder
+            Liberal folder
+                The Young Turks channel
+            @@Conservative folder
+                Joe Rogan channel
+                Mark Dice channel
+
+These new download options only apply to Joe Rogan and Mark Dice. They don't apply to The Young Turks, which are still using the *previous* set of download options. They don't apply to CollegeHumor or PewDiePie, which are still using the *default* download options. 
+
+##Future plans
+* Fix the endless crashes, somehow
+* Support for multiple databases (so you can store videos on two external hard drives at the same time)
+* Add download scheduling
+* Add video archiving
+* Allow selection of multiple videos in the catalogue, so the same action can be applied to all of them at the same time
+* Tie channels and playlists together, so that they won't both download the same video
+* Add tooltips for everything
+* Add more youtube-dl options
+
+##Known issues
+* Tartube crashes continuously and often
+* Alphabetic sorting of channels/playlists/folders doesn't always work as intended, due to an unresolved Gtk issue
+* Channels/playlists/folder selection does not always work as intended, due to an unresolved Gtk issue
+* Users can type in comboboxes, but this should not be possible
+
+##Contributing
+* Report a bug: Use the Github [issues](https://github.com/axcore/tartube/issues) page
+
+## Authors
+See the [AUTHORS](AUTHORS) file.
+
+## License
+Tartube is licensed under the [GNU General Public License v3.0](https://www.gnu.org/licenses/gpl-3.0.en.html).
+
+
+
+✨🍰✨
+# tartube
diff --git a/icons/COPYING b/icons/COPYING
@@ -0,0 +1,36 @@
+COPYING
+
+All files in the ../dialogue sub-directory
+All files in the ../win sub-directory
+
+Author: Vectorgraphit 
+Source: https://www.iconfinder.com/icons/199499/
+
+This work is licensed under the Creative Commons Attribution 3.0 Unported
+License. To view a copy of this license, visit
+http://creativecommons.org/licenses/by/3.0/ or send a letter to Creative 
+Commons, 444 Castro Street, Suite 900, Mountain View, California, 94041, USA.
+
+
+All files in the ../large sub-directory
+All files in the ../small sub-directory
+All files in the ../template sub-directory
+
+Author: FatCow Web Hosting
+Source: https://www.fatcow.com/free-icons
+
+This work is licensed under the Creative Commons Attribution 3.0 Generic
+License. To view a copy of this license, visit
+http://creativecommons.org/licenses/by/3.0/ or send a letter to Creative 
+Commons, 444 Castro Street, Suite 900, Mountain View, California, 94041, USA.
+
+All files in the ../locale directory
+
+Author: Mr. Hopnguyen
+Source: https://www.iconfinder.com/icons/2634450/
+
+This work is licensed under the Creative Commons Attribution 3.0 Unported
+License. To view a copy of this license, visit
+http://creativecommons.org/licenses/by/3.0/ or send a letter to Creative 
+Commons, 444 Castro Street, Suite 900, Mountain View, California, 94041, USA.
+
diff --git a/icons/dialogue/system_icon_64.png b/icons/dialogue/system_icon_64.png
diff --git a/icons/large/channel_both.png b/icons/large/channel_both.png
diff --git a/icons/large/channel_left.png b/icons/large/channel_left.png
diff --git a/icons/large/channel_none.png b/icons/large/channel_none.png
diff --git a/icons/large/channel_right.png b/icons/large/channel_right.png
diff --git a/icons/large/folder_black_both.png b/icons/large/folder_black_both.png
diff --git a/icons/large/folder_black_left.png b/icons/large/folder_black_left.png
diff --git a/icons/large/folder_black_none.png b/icons/large/folder_black_none.png
diff --git a/icons/large/folder_black_right.png b/icons/large/folder_black_right.png
diff --git a/icons/large/folder_blue_both.png b/icons/large/folder_blue_both.png
diff --git a/icons/large/folder_blue_left.png b/icons/large/folder_blue_left.png
diff --git a/icons/large/folder_blue_none.png b/icons/large/folder_blue_none.png
diff --git a/icons/large/folder_blue_right.png b/icons/large/folder_blue_right.png
diff --git a/icons/large/folder_green_both.png b/icons/large/folder_green_both.png
diff --git a/icons/large/folder_green_left.png b/icons/large/folder_green_left.png
diff --git a/icons/large/folder_green_none.png b/icons/large/folder_green_none.png
diff --git a/icons/large/folder_green_right.png b/icons/large/folder_green_right.png
diff --git a/icons/large/folder_red_both.png b/icons/large/folder_red_both.png
diff --git a/icons/large/folder_red_left.png b/icons/large/folder_red_left.png
diff --git a/icons/large/folder_red_none.png b/icons/large/folder_red_none.png
diff --git a/icons/large/folder_red_right.png b/icons/large/folder_red_right.png
diff --git a/icons/large/folder_yellow_both.png b/icons/large/folder_yellow_both.png
diff --git a/icons/large/folder_yellow_left.png b/icons/large/folder_yellow_left.png
diff --git a/icons/large/folder_yellow_none.png b/icons/large/folder_yellow_none.png
diff --git a/icons/large/folder_yellow_right.png b/icons/large/folder_yellow_right.png
diff --git a/icons/large/playlist_both.png b/icons/large/playlist_both.png
diff --git a/icons/large/playlist_left.png b/icons/large/playlist_left.png
diff --git a/icons/large/playlist_none.png b/icons/large/playlist_none.png
diff --git a/icons/large/playlist_right.png b/icons/large/playlist_right.png
diff --git a/icons/large/video_both.png b/icons/large/video_both.png
diff --git a/icons/large/video_left.png b/icons/large/video_left.png
diff --git a/icons/large/video_none.png b/icons/large/video_none.png
diff --git a/icons/large/video_right.png b/icons/large/video_right.png
diff --git a/icons/locale/flag_uk.png b/icons/locale/flag_uk.png
diff --git a/icons/small/channel.png b/icons/small/channel.png
diff --git a/icons/small/check.png b/icons/small/check.png
diff --git a/icons/small/download.png b/icons/small/download.png
diff --git a/icons/small/error.png b/icons/small/error.png
diff --git a/icons/small/folder.png b/icons/small/folder.png
diff --git a/icons/small/have_file.png b/icons/small/have_file.png
diff --git a/icons/small/no_file.png b/icons/small/no_file.png
diff --git a/icons/small/ok.png b/icons/small/ok.png
diff --git a/icons/small/playlist.png b/icons/small/playlist.png
diff --git a/icons/small/system_error.png b/icons/small/system_error.png
diff --git a/icons/small/video.png b/icons/small/video.png
diff --git a/icons/small/warning.png b/icons/small/warning.png
diff --git a/icons/template/edit_button.png b/icons/template/edit_button.png
diff --git a/icons/template/heart.png b/icons/template/heart.png
diff --git a/icons/template/heart_empty.png b/icons/template/heart_empty.png
diff --git a/icons/template/template_alt_both.png b/icons/template/template_alt_both.png
diff --git a/icons/template/template_alt_left.png b/icons/template/template_alt_left.png
diff --git a/icons/template/template_alt_right.png b/icons/template/template_alt_right.png
diff --git a/icons/template/template_both.png b/icons/template/template_both.png
diff --git a/icons/template/template_left.png b/icons/template/template_left.png
diff --git a/icons/template/template_right.png b/icons/template/template_right.png
diff --git a/icons/win/system_icon_128.png b/icons/win/system_icon_128.png
diff --git a/icons/win/system_icon_16.png b/icons/win/system_icon_16.png
diff --git a/icons/win/system_icon_24.png b/icons/win/system_icon_24.png
diff --git a/icons/win/system_icon_256.png b/icons/win/system_icon_256.png
diff --git a/icons/win/system_icon_32.png b/icons/win/system_icon_32.png
diff --git a/icons/win/system_icon_48.png b/icons/win/system_icon_48.png
diff --git a/icons/win/system_icon_512.png b/icons/win/system_icon_512.png
diff --git a/icons/win/system_icon_64.png b/icons/win/system_icon_64.png