aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: aaba47436908cac9d79b06889aa32edff542c68e (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
# YouTube to MP3 Auto Tagger
A GUI wrapper for yt-dlp that downloads YouTube videos to MP3 and automatically adds ID3 tags based on uploader name, title, and thumbnail

###
![image](https://user-images.githubusercontent.com/21994085/232991117-a41a33e1-f45a-4043-aa6a-e886a31d2f11.png)
###
![image](https://user-images.githubusercontent.com/21994085/233506083-01842f0d-3aa9-48fb-a2b4-497be6019e93.png)
###
![image](https://user-images.githubusercontent.com/21994085/232990936-50c96722-e7ed-4945-8971-f90e06a24fc9.png)
###
![image](https://user-images.githubusercontent.com/21994085/199175477-b2d6d5ae-d7db-455c-813f-ad1d3af7fac5.png)

# Manual
If you don't want to use the built-in GUI builder to create a "task file", you can write it manually in your file of choice

Each line will be treated as a download job (video), you may use either the full `youtube.com` or shortened  `youtu.be` link
```
URL,START_TIME-END_TIME,FILENAME_OVERRIDE     (HH:MM:SS  Timestamp Format)
```
`FILENAME_OVERRIDE` is optional and only available if specifying a time range. 
- Processed files will be automatically renamed to contain what is in this field. This is useful for videos that have multiple songs you want to download in them (so you can tell which file is which).

ex: `https://www.youtube.com/watch?v=qvj_QSqOrBw,00:01:10-00:01:40,MySong`
- Download video `https://www.youtube.com/watch?v=qvj_QSqOrBw` from `1 min 10s` to `1 min 40s` (30s total)
- The output file will be renamed to contain `MySong` in the filename


# Requirements
The packages/programs below must be accessible from any path. (If you are on Windows these will need to be in your PATH environment variable)
- ffmpeg
- yt-dlp
- Java 11 or above

You must also have one of the following browsers installed and have used it to log into YouTube. This is to mitigate yt-dlp from being blocked by YouTube
```
brave, chrome, chromium, edge, firefox, opera, safari, vivaldi, whale
```

> Although this program comes with some rate-limit circumvention techniques, videos may still be possible for downloads to fail. When this is the case, try again later

# Binaries
Pre-built binaries are also available. You can download it from the [Releases](https://github.com/pinapelz/ytID3AutoTag/releases) section

You can either run it like an application

For a debug log run it as `java -jar ytID3AutoTag.jar` from the terminal

# How to Update?
Download the new binary from releases, and simply overwrite the old file. Your configs will be migrated.
send patches to the email below
yukais@pinapelz.com
include the subject [PATCH repo_name]
pinapelz.com
homepage