# Freetube-import
Creates [FreeTube](https://freetubeapp.io/) .db playlist files from a list of youtube urls (.txt) or from .csv files exported from 'Google takeout'.
Run the scrip with a path to a valid .txt file of youtube urls, or youtube's .csv playlist file. Then import the resulting .db file into FreeTube.
Install via pip:
pip install freetube-import
https://pypi.org/project/freetube-import/
Basic usage:
freetube-import <file>... <file2> <file3>
Help message:
usage: freetube_import.py [-h] [-a] [-b] [-e] [-s] [filepath ...]
Import youtube playlists
positional arguments:
filepath path to a valid .txt or .csv playlist file or files
optional arguments:
-h, --help show this help message and exit
-a, --list-all Takes all .txt and csv files as input from the current working directory.
-b, --list-broken-videos
Lists videos that were added but have possibly broken metadata (for debugging).
-e, --log-errors Also lists the videos that failed the metadata fetch
-s, --stdin Takes stdin as input and outputs dirextly to stdout
-n NAME, --name NAME sets a name for playlist, otherwise uses input filename
While buggy and experimental `stdin` mode can used in scripts and automation. Not for average users.
cat test.txt | freetube-import -s > std_test.db
It might be usefull to set a name that shows up in FreeTube. Otherwise in stdin mode a placeholder name is generated.
cat test.txt | freetube-import -s -n playlist-name > std_test.db
pro tip: Try appending the ouput to FreeTube's own playlist.db file. So playlists get automatically added. (backup your files beforehand, close freetube, at your own risk)
cat test.txt | freetube-import -s -n playlist-name >> your/path/FreeTube/playlists.db
Works without YouTube api through a custom version of [YouTube-search library](https://github.com/joetats/youtube_search/). Also works atleast on piped links, probably also on lists of Invidious links and other links that follow the standard youtube url format.
### Dependencies
pip install requests
https://pypi.org/project/requests/
pip install tqdm
https://pypi.org/project/tqdm/
Raw data
{
"_id": null,
"home_page": null,
"name": "freetube-import",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "freetube, youtube, tube, playlist, import, cli, console, video, videos",
"author": "NoSpiner",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/c9/47/dba99152804b79ff7afd21260cc726785355731e3ad016d13b25657278dd/freetube_import-0.33.0.tar.gz",
"platform": null,
"description": "\n\n\n\n# Freetube-import\nCreates [FreeTube](https://freetubeapp.io/) .db playlist files from a list of youtube urls (.txt) or from .csv files exported from 'Google takeout'.\n\nRun the scrip with a path to a valid .txt file of youtube urls, or youtube's .csv playlist file. Then import the resulting .db file into FreeTube.\n\n\n\nInstall via pip:\n\n pip install freetube-import\n\nhttps://pypi.org/project/freetube-import/\n\nBasic usage:\n\n freetube-import <file>... <file2> <file3>\n\nHelp message:\n\n usage: freetube_import.py [-h] [-a] [-b] [-e] [-s] [filepath ...]\n\n Import youtube playlists\n\n positional arguments:\n filepath path to a valid .txt or .csv playlist file or files\n\n optional arguments:\n -h, --help show this help message and exit\n -a, --list-all Takes all .txt and csv files as input from the current working directory.\n -b, --list-broken-videos\n Lists videos that were added but have possibly broken metadata (for debugging).\n -e, --log-errors Also lists the videos that failed the metadata fetch\n -s, --stdin Takes stdin as input and outputs dirextly to stdout\n -n NAME, --name NAME sets a name for playlist, otherwise uses input filename\n\nWhile buggy and experimental `stdin` mode can used in scripts and automation. Not for average users.\n\n cat test.txt | freetube-import -s > std_test.db\n\nIt might be usefull to set a name that shows up in FreeTube. Otherwise in stdin mode a placeholder name is generated.\n\n cat test.txt | freetube-import -s -n playlist-name > std_test.db\n\npro tip: Try appending the ouput to FreeTube's own playlist.db file. So playlists get automatically added. (backup your files beforehand, close freetube, at your own risk)\n\n cat test.txt | freetube-import -s -n playlist-name >> your/path/FreeTube/playlists.db\n\n\nWorks without YouTube api through a custom version of [YouTube-search library](https://github.com/joetats/youtube_search/). Also works atleast on piped links, probably also on lists of Invidious links and other links that follow the standard youtube url format.\n\n### Dependencies \n\n pip install requests\nhttps://pypi.org/project/requests/\n\n pip install tqdm\nhttps://pypi.org/project/tqdm/\n",
"bugtrack_url": null,
"license": null,
"summary": "Converts text and youtube .csv files into FreeTube playlists",
"version": "0.33.0",
"project_urls": {
"Homepage": "https://github.com/NoSpiner/Freetube-import",
"Issues": "https://github.com/NoSpiner/Freetube-import/issues"
},
"split_keywords": [
"freetube",
" youtube",
" tube",
" playlist",
" import",
" cli",
" console",
" video",
" videos"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "1b8e90404770f07af9dbbbd44f6d533bc1855a4423fc2695a8d51afaa0935e15",
"md5": "6981ba745728580126825ccf7833a07f",
"sha256": "c21e0a17de4f1d573401d18472a5f30ee7c786641cf6dcce53eb32173d57a69a"
},
"downloads": -1,
"filename": "freetube_import-0.33.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6981ba745728580126825ccf7833a07f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 8257,
"upload_time": "2025-07-14T15:06:48",
"upload_time_iso_8601": "2025-07-14T15:06:48.656070Z",
"url": "https://files.pythonhosted.org/packages/1b/8e/90404770f07af9dbbbd44f6d533bc1855a4423fc2695a8d51afaa0935e15/freetube_import-0.33.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c947dba99152804b79ff7afd21260cc726785355731e3ad016d13b25657278dd",
"md5": "89dd36cab3ac73368c2ceb29a4bf42b9",
"sha256": "196953b5dcefb45a243f769542bb826a7677e24eed7c6aaad8445ef2b3a03ca3"
},
"downloads": -1,
"filename": "freetube_import-0.33.0.tar.gz",
"has_sig": false,
"md5_digest": "89dd36cab3ac73368c2ceb29a4bf42b9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 7193,
"upload_time": "2025-07-14T15:06:49",
"upload_time_iso_8601": "2025-07-14T15:06:49.890000Z",
"url": "https://files.pythonhosted.org/packages/c9/47/dba99152804b79ff7afd21260cc726785355731e3ad016d13b25657278dd/freetube_import-0.33.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-14 15:06:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "NoSpiner",
"github_project": "Freetube-import",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "freetube-import"
}
JSON
