Skip to main content

Youtube subscription manager

Project description


PyPI example docs Github GitLab

If you have a problem, create an issue rather than sending me an email otherwise the response time will be longer, Thanks.


Youtube_subscription_manager is an alternative to to retrieve the videos of your subscriptions feed without requires an account (You can also recover the videos of other platform).

It can gather informations about every video in a playlist, a channel or your subsciptions feed and outputs it as a html page, a detailed list or a list of links.


  1. Clone the project: git clone
  2. Open the folder you just cloned : cd youtube-sm
  3. Execute the setup: sudo python3 install
  4. Recover your subscription file in youtube and you are ready to go !


  1. Download your subscriptions configuration from (here)
  2. Once this is done, you may load it by using the following command :
youtube-sm --init [file]
  1. Finally, you can start using the program using the commands shown below :
youtube-sm [OPTIONS]


-a           URL       Add a sub to your sub list.
-e                     Edit your sub list.
-h                     Print this help text and exit.
-l           URL       Analyze only one sub.
-m           MODE      Choose the type of the output file (html, json, raw, list).
-r                     Remove the cache.
-t           DAYS      Select how many DAYS ago the last content written to your file will be dated .
-v                     Verbose.
--af         FILE      Add a list of sub to your sub list.
--ax         FILE      Add a xml file in your sub list.
--cat                  View your subscriptions.
--css        STYLE     Export the css files (light, dark, switch).
--dead                 Show the dead channels + those who posted no videos.
--help                 Print this help text and exit.
--html                 Recover sub with html page instead of RSS. This method recover more videos.
--init       FILE      Remove all your subs and add new.
--loading              Print a progress bar.
--old                  Show channels who didn't post videos since DAYS.
--output     FILE      Write the output in FILE.
--version              Print version.

Support Platforms

  • Dailymotion
  • Evous Manifestation
  • Infoconcert
  • La Quadrature du Net
  • Peertube
  • Reddit
  • Revolution Permanente
  • Twitter
  • Youtube


  • Basic
  • Your sub since 1 month
youtube-sm -t 30 --css --loading
  • All the videos of a channel
youtube-sm -l -t -1 -m list --loading -r --output test.csv
  • Add a sub
youtube-sm -a

Type of File

Raw :

{date}     {video_id}     {channel_id}     {title}     {channel}     {link_pic}

List :{video_id}

View :


Json :

	"url": {
		"content": "",
		"image": "",
		"uploader": ""
	"date": "2020-04-23 16:08:22",
	"title": "Video Title",
	"uploader": "Channel",
	"views": "228283"

Html :

<!--NEXT -->
<div class="video">
	<a class="left" href="{video_id}">
		<div class="container">
			<img src="{link_pic}">
			<div class="bottom-right">{time}</div>
	<a href="{video_id}"><h4>{title}</h4> </a>
	<a href="{channel_id}"> <p>{channel}</p> </a>
	<p class="clear"></p>


3 files are generated by the program : sub.swy, log and data/.

  • sub.swy is a list of yours subscriptions.
  • log contains the script's time of execution.
  • data/ is a folder where the information for every video are stored.

These 3 files are generated in:

  • Windows: C:\Users\<name>\.youtube_sm\.
  • Linux/MacOS: /home/<name>/.cache/youtube_sm/..


  • Python 3


  • Linux
  • Windows
  • Android (Termux)
  • MacOS


Phone screen PC screen

Project details

Download files

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

Source Distribution

youtube_sm-2022.6.24.tar.gz (29.4 kB view hashes)

Uploaded source

Built Distribution

youtube_sm-2022.6.24-py3-none-any.whl (37.0 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page