Skip to main content

YouTube File System

Project description

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


You can install YTFS with pip:

$ pip3 install ytfs

You need Python 3.4 or newer.


Here some basics are shown. See documentation for more detailed description.


Mount YTFS in an empty directory, for example:

$ mkdir youtube
$ ytfs youtube


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/


To unmount, use fusermout -u and specify the directory where YTFS was mounted:

$ fusermout -u youtube


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.


If you want to suggest a new feature or help with development in any way, please open an issue or contact me via email.


MIT (c) Adrian Włosiak

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

ytfs-0.99a2-py3-none-any.whl (19.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page