# off-the-rip

**Repository Path**: mirrors_alexgorbatchev/off-the-rip

## Basic Information

- **Project Name**: off-the-rip
- **Description**: Downloads audio, artwork, and metadata from Soundcloud
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-24
- **Last Updated**: 2026-07-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Off the Rip

"Future Proof" method of downloading Soundcloud audio and embedding ID3 tags (title, artist, artwork) within the resulting file.

<img src="http://i.imgur.com/flBrvcn.jpg">

## Dependencies
These dependencies must be met before attempting to install off-the-rip
```sh
# Mac
brew install eyeD3 rtmpdump

# Linux
sudo apt-get --assume-yes install eyeD3 rtmpdump
```

## Installing
Once dependencies have been met, you can install off-the-rip
```sh
npm i -g off-the-rip

# Update
npm update -g off-the-rip
```

## Developing
After cloning the repo...
```sh
npm install
npm link # Gives you access to `otr` in your terminal
```

## Usage

### CLI
The CLI takes two parameters, `url` and `dir`. The second is optional.
```sh
otr https://soundcloud.com/artist/track ~/Music

If a `dir` is not specified, the current directory will be used.
```

### Node
```javascript
var otr = require('off-the-rip');

otr('https://soundcloud.com/artist/track', '~/Music', function() {
   // Done
});
```

## How it works
* Network traffic on the soundcloud page is monitored and API requests and artwork are intercepted.
* Page information is scraped (Title, Artist, etc)
* Data is sent to Node where ID3 tags including artwork is written to the dist folder

## Disclaimer
This tool is in no way shape or form to be used for downloading copyrighted music, it is designed and built as a proof-of-concept.

## License
MIT