yt-playlist

4917d41206a20cf4dbdb4a728e9cc0248f28d650 · Alexander Tabakov · Apr 30, 2023 19:45
+41 · 3 files changed
.gitignore +1 −0
README.md +40 −0
assets/format_csv.png binary
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..924cea8
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+.etc
diff --git a/README.md b/README.md
index 9c04342..18263c1 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,41 @@
 # yt-playlist
+
+yt-playlist is a tool that allows to export YouTube playlists, export YouTube "Watch later" list and export YouTube "Liked videos". It supports exporting to JSON and CSV formats.
+
+## Usage
+
+```bash
+yt-playlist -h
+usage: yt-playlist [-h] [--browser BROWSER] [-f {csv,json}] [-o OUTPUT] [-v] playlist [playlist ...]
+
+yt-playlist exports YouTube playlists to JSON or CSV
+
+positional arguments:
+  playlist              playlist URL
+
+optional arguments:
+  -h, --help            show this help message and exit
+  --browser BROWSER     browser where you logged in to YouTube
+  -f {csv,json}, --format {csv,json}
+                        output's format
+  -o OUTPUT, --output OUTPUT
+                        filename to store output, by default it's printed to stdout
+  -v, --verbose         verbose
+```
+
+## Show case
+
+```bash
+yt-playlist https://www.youtube.com/playlist\?list\=PL0XfG7TzasxNCl8a-SdyvSoazX1VYBweF -f csv -o test.csv
+```
+
+![YouTube playlist exported to CSV](/assets/format_csv.png)
+
+
+## Dependencies
+
+yt-playlist is using [yt-dlp](https://github.com/yt-dlp) under the hood.
+
+## Keywords
+
+YouTube export playlist. YouTube export Watch later list. YouTube export liked videos. YouTube export playlist to CSV. YouTube export playlist to JSON. YouTube export private playlist.
diff --git a/assets/format_csv.png b/assets/format_csv.png
new file mode 100644
index 0000000..c7a6f41
Binary files /dev/null and b/assets/format_csv.png differ