Your Name
64 lines
1.7 KiB
Markdown
64 lines
1.7 KiB
Markdown
# How-To: `pos media`
|
|
|
|
Download audio and video from the web via `yt-dlp`. Tools: `mp3`, `mp4`.
|
|
|
|
| Tool | What it does |
|
|
|------|--------------|
|
|
| `pos media mp3` | Download audio, convert to MP3 |
|
|
| `pos media mp4` | Download video with interactive format selection |
|
|
|
|
Requires `yt-dlp` (`sudo apt install yt-dlp`); the tools fail with a clean
|
|
error message instead of a raw `command not found` if it's missing.
|
|
|
|
---
|
|
|
|
## `pos media mp3` — audio as MP3
|
|
|
|
```bash
|
|
pos media mp3 <url>
|
|
```
|
|
|
|
Extracts and converts the audio track to MP3 in the current directory.
|
|
|
|
```bash
|
|
pos media mp3 https://youtube.com/watch?v=dQw4w9WgXcQ
|
|
```
|
|
|
|
**Recipe:** batch — loop over a list of URLs:
|
|
```bash
|
|
while read -r url; do pos media mp3 "$url"; done < urls.txt
|
|
```
|
|
|
|
**Troubleshooting:** MP3 conversion needs `ffmpeg`; if the tool errors about a
|
|
missing postprocessor, `sudo apt install ffmpeg`. Single-song playlists: use the
|
|
video URL directly, or a playlist entry.
|
|
|
|
---
|
|
|
|
## `pos media mp4` — video with format choice
|
|
|
|
```bash
|
|
pos media mp4 <url>
|
|
```
|
|
|
|
Lists the available formats (`yt-dlp -F`) and lets you pick interactively, then
|
|
downloads to the current directory.
|
|
|
|
```bash
|
|
pos media mp4 https://youtube.com/watch?v=dQw4w9WgXcQ
|
|
```
|
|
|
|
**Recipe:** grab a 4K stream for later — pick the highest `video only` format +
|
|
best audio; yt-dlp merges them (again needs `ffmpeg`).
|
|
|
|
**Troubleshooting:**
|
|
- Format list is empty → the site/age-gate requires cookies/auth; yt-dlp can't
|
|
access it — use a URL yt-dlp supports, or update yt-dlp (`sudo apt upgrade yt-dlp`).
|
|
- Very large downloads: ensure free space; files land in the current directory.
|
|
|
|
---
|
|
|
|
## Related
|
|
|
|
- Reference: [DOC/POS.md → media](../POS.md)
|