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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
|
# Full disclosure, completely vibe coded, uses squid.wtf's downloading service, but it works :+1
# CSV is downloaded from https://www.tunemymusic.com/transfer/spotify-to-file
# Squid Downloader
A CLI tool for downloading high-quality music from multiple streaming services.
## Features
- **Multiple Services**: Tidal, Amazon Music, SoundCloud, KHInsider
- **High-Quality Audio**: Support for Hi-Res FLAC (24-bit/192kHz), CD-quality FLAC, and lossy formats
- **Artist Filtering**: Optionally provide artist name to improve search accuracy
- **CSV Import**: Import tracks from CSV files with smart fuzzy matching
- **Pretty Output**: Beautiful CLI output with colors, tables, and progress bars
- **Error Handling**: Clear, formatted error messages
## Installation
```bash
cargo build --release
```
The binary will be at `./target/release/squid-downloader`.
## Usage
### Search for tracks
```bash
# Basic search
squid-downloader search "Waiting For Love"
# Search with artist filter for better accuracy
squid-downloader search "Waiting For Love" -a "Avicii"
# Limit results
squid-downloader search "Bohemian Rhapsody" -n 5
```
### Download a track
```bash
# Download by search query (will prompt for selection)
squid-downloader track "Levels"
# Download with artist filter
squid-downloader track "Levels" -a "Avicii"
# Download first result without prompting
squid-downloader track "Levels" -a "Avicii" -f
# Download by track ID
squid-downloader track 48717877
```
### Import from CSV
```bash
# Import and download tracks from CSV
squid-downloader csv tracks.csv
# Set minimum confidence threshold (default: 0.6)
squid-downloader csv tracks.csv -t 0.8
# Skip confirmation prompt
squid-downloader csv tracks.csv -y
```
#### CSV Format
The CSV file should have the following headers:
```csv
Track name,Artist name,Album,Playlist name,Type,ISRC,Spotify - id
"Bleed","Connor Kauffman","Bleed","Favorite Songs","Favorite","QZPY62100085","4k8D363TGNjILbQRciQfBD"
"Running Up That Hill","Kate Bush","Hounds Of Love","Favorite Songs","Favorite","GBCNR8500002","1PtQJZVZIdWIYdARpZRDFO"
```
#### Matching Algorithm
The CSV import uses a smart matching algorithm:
1. Searches for each track with the artist name
2. If multiple artists are detected (separated by `,`, `&`, `/`, `;`), searches for each separately
3. Also searches for the track name alone
4. Scores candidates using:
- Title similarity (45% weight)
- Artist similarity (35% weight)
- Album similarity (20% weight)
5. Uses Jaro-Winkler distance for fuzzy matching
6. Only downloads tracks above the confidence threshold
### Download an album
```bash
squid-downloader album "Stories"
squid-downloader album 12345678 # by album ID
```
### Download a playlist
```bash
squid-downloader playlist 12345678
```
### Get track info
```bash
squid-downloader info 48717877
```
### List available services and qualities
```bash
squid-downloader list
```
## Global Options
| Option | Description |
|--------|-------------|
| `-o, --output` | Output directory for downloads (default: `./downloads`) |
| `-q, --quality` | Audio quality: `hires`, `lossless`, `high`, `low`, `mp3` |
| `-s, --service` | Streaming service: `tidal`, `amazon`, `soundcloud`, `khinsider` |
| `--quiet` | Suppress non-essential output |
## Audio Qualities
| Quality | Format | Description |
|---------|--------|-------------|
| `hires` | FLAC | 24-bit/192kHz (Hi-Res) |
| `lossless` | FLAC | 16-bit/44.1kHz (CD Quality) |
| `high` | AAC | 320kbps |
| `low` | AAC | 96kbps |
| `mp3` | MP3 | 320kbps |
## Examples
```bash
# Download a Hi-Res FLAC from Tidal
squid-downloader track "Wake Me Up" -a "Avicii" -q hires -f
# Download to custom directory
squid-downloader track "Levels" -o ~/Music/downloads
# Import playlist from CSV with high confidence threshold
squid-downloader csv my_playlist.csv -t 0.8 -y -q lossless
```
## License
MIT
|
