Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rasguanabana/ytfs
YouTube File System
https://github.com/rasguanabana/ytfs
Last synced: 23 days ago
JSON representation
YouTube File System
- Host: GitHub
- URL: https://github.com/rasguanabana/ytfs
- Owner: rasguanabana
- License: mit
- Created: 2015-07-05T11:59:35.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2020-08-26T23:05:27.000Z (about 4 years ago)
- Last Synced: 2024-10-01T11:43:31.526Z (about 1 month ago)
- Language: Python
- Size: 151 KB
- Stars: 1,098
- Watchers: 29
- Forks: 45
- Open Issues: 9
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
README
.. image:: http://i.imgur.com/Wbss2gh.png
*****************************************
**YTFS** - File system which enables you to search and play movies from YouTube as files - with tools of your choice.
Based on FUSE, written in Python 3.Dependencies, manual and documentation: `Read the Docs `_
Installation
============You can install YTFS with pip::
$ pip3 install ytfs
You need **Python 3.4** or newer.
.. important:: Only systems where FUSE lib (or compatible) is available are supported. YTFS was tested on Linux, OS X and FreeBSD.
Usage
=====Here some basics are shown. See `documentation `_ for more detailed description.
Mount
-----Mount YTFS in an empty directory, for example::
$ mkdir youtube
$ ytfs youtubeSearch
------Enter the directory where YTFS is mounted and create a directory whose name is your search query. You can use GUI or CLI (note that the latter is most stable). If you like command line::
$ cd youtube
$ mkdir "rick astley"Search results will appear in the directory you have created.
You can narrow your search to a specific channel::
$ mkdir "foo bar baz channel:foochannel"
Other additional parameters like ``before:``, ``after:`` or ``max:`` are available. See `docs `_ for details.
To navigate between search pages use ``next`` and ``prev`` scripts in the search directory. Note that they have a space character at the beginning, thereby in most shells/file managers they should be alphabetically first::
$ ./\ next
$ ./\ prevPlayback
--------You can use search results as regular files. Open them with your favourite player, for example::
$ mkdir "rick astley"
$ cd rick\ astley
$ mplayer "Rick Astley - Never Gonna Give You Up.mp4"Or you can copy them on your hard drive::
$ cp "Rick Astley - Never Gonna Give You Up.mp4" ~/youtube-collection/
Unmounting
----------To unmount, use ``fusermount -u`` and specify the directory where YTFS was mounted::
$ fusermount -u youtube
Dependencies
============* FUSE (Python module: `fusepy `_)
* `youtube-dl `_ (this dependency will be droped in the future)
* `Requests `_If you mount YTFS with options to download full videos at heighest quality, then audio and video merging may be needed. In such case FFmpeg or Libav is required.
Contribute!
===========If you want to suggest a new feature or help with development in any way, please open an issue or contact me via email.
License
=======MIT (c) Adrian Włosiak