goffy

KO | EN

gitlite — search

#javascript #python #typescript #golang #android #rust #deep-learning #linux #docker #awesome #pytorch #mcp #ios #open-source

(★ 20)

A command-line tool for downloading public playlists, albums and individual tracks via Spotify URLs.

goffy Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# goffy

A command-line tool for downloading public playlists, albums and tracks to your computer or mobile device via Spotify URLs.

> Downloads are not done directly from Spotify, but from YouTube (if a song matches).

**goffy** does not use any official API, but its own unofficial "API" (light and rustic). Additionally, it has no features related to the private data of your Spotify account. Lastly, you can save the music on your computer or mobile device (this makes more sense).

![Alt text](https://raw.githubusercontent.com/mathenz/goffy/main/examples/album.gif)

## Features

- Download a playlist (publics only)
- Download an album
- Download a single track
- Download multiple tracks from a txt file

## Requirements

* [FFmpeg](https://ffmpeg.org/) (required to add metadata to audio files)

## Installation
Install by downloading [latest release](https://github.com/mathenz/goffy/releases/tag/v1.1.1).

Or running:
```
go install github.com/mathenz/goffy@latest
```
> If a version earlier than the latest one (v1.1.1) was installed, replace "latest" with "v1.1.1" in the previous command.

## Usage

#### Download music to your local machine
```
goffy [option] [url] -d [path/to/musicfolder/]
```
#### Download music to your mobile device
```
goffy -m [option] [url]
```

In case you want to download multiple tracks from a text file, simply change ```[url]``` to ```[path/to/songs.txt]```
> To correctly read all tracks from a text file, place the URL of each track on its own line.

### Options

```
-p,  download a playlist
-a,  download an album
-t,  download a single track
-f,  download multiple tracks from a text file
```
#### On mobile devices? How does it work?

Very simple. The music will be stored in a temporary directory on the local machine, then that folder is compressed and presented at the address ```<YOUR_HOSTMACHINE_IP>:8080```. You, from your mobile device, will access from the browser and get the music. Afterwards, both the temporary folder and the zip file will be deleted.

### Examples

- If you want to save the music on your local machine:
   > 
   ```
   goffy -p https://open.spotify.com/playlist/37i9dQZF1EIh4XfqZs7jCB?si=5855691d6a874444 -d /path/to/musicfolder/
   ```
   ```
   goffy -a https://open.spotify.com/album/6Ym9q86JqAa4yi6BDaO35H?si=_Jcjf0sFTFuVCTSj0XYhcw -d /path/to/musicfolder/
   ```
   ```
   goffy -t https://open.spotify.com/track/5WSqNyypJ0hITVpvJMetqQ?si=5d9759cc4d8d4e57 -d /path/to/musicfolder/
   ```
   ```
   goffy -f /path/to/songs.txt -d /path/to/musicfolder/
   ```
   >
- Or if you want to save the music on your mobile device:
   > 
   ```
   goffy -m -p https://open.spotify.com/playlist/37i9dQZF1EIh4XfqZs7jCB?si=5855691d6a874444
   ```
   ```
   goffy -m -a https://open.spotify.com/album/6Ym9q86JqAa4yi6BDaO35H?si=_Jcjf0sFTFuVCTSj0XYhcw
   ```
   ```
   goffy -m -t https://open.spotify.com/track/5WSqNyypJ0hITVpvJMetqQ?si=5d9759cc4d8d4e57
   ```
   ```
   goffy -m -f /path/to/songs.txt
   ```
   >

> To obtain the url of a playlist, an album or a track, just click on the three dots > Share > Copy-Link-to-Playlist / Copy-Album-Link / Copy-Song-Link

### Contributing

Feel free to open a pull request to:

* Fix bugs
* Suggest improvements

goffy

goffy Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

goffy

goffy Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README