Git Product home page Git Product logo

nehm's Introduction

Logo

nehm is a console tool, which downloads, sets ID3 tags and adds to your iTunes library (if you use macOS) your SoundCloud likes in convenient way.

List List List List

(click to zoom)

Description

nehm is a console tool written in Go. It can download your likes and search tracks from SoundCloud. All downloaded tracks are ID3 tagged and can be added to iTunes playlist, if you use macOS.

nehm wasn't tested on Windows machine, so it can be very buggy on it. I'll be very thankful, if you will report any bug.

If you have ideas to improve nehm, issues and pull requests are always welcome! Also, if you have difficulties with installation/configuration/usage of nehm, don't hesitate to write an issue. I will answer as soon as possible.

Installation

Install via go command:

$ go get -u github.com/bogem/nehm

or you can download and install binary from latest release.

Configuration

First of all, you should configure nehm:

  1. Create a file .nehmconfig in your home directory

  2. Write in it configuration, i.e. set three variables in YAML format:

permalink - permalink of your SoundCloud profile (last word in your profile URL. More in FAQ)

dlFolder - filesystem path to download folder, where will be downloaded all tracks. By default, your tracks are being downloaded to your home directory

itunesPlaylist - name of iTunes playlist, where will be added all tracks (if you're using macOS). By default, your tracks are not being added to iTunes

Example:

permalink: bogem
dlFolder: /Users/bogem/Music
itunesPlaylist: iPod

Usage Examples

Type nehm help to list of all available commands or nehm help COMMAND for specific command.

Also commands may be abbreviated to one symbol length. For example, you can input nehm s instead of nehm search.

Get list of likes and download selected

$ nehm

Get list of likes of nasa

$ nehm -p nasa

Synchronize your likes with current folder

$ nehm sync -f . -i ''

Download last like

$ nehm get

Download last 3 likes

$ nehm get 3

Download second like and don't add it to iTunes playlist

$ nehm get -o 1 -i ''

Download track from URL

$ nehm get soundcloud.com/nasa/golden-record-russian-greeting

Search for tracks and download them

$ nehm search nasa

FAQ

Q: What is permalink?

A: Permalink is the last word in your profile url. Example: for profile url soundcloud.com/qwerty permalink is qwerty


Q: How can I add track to iTunes' music library, but not to any playlist?

A: It depends on language you're using on your Mac. The name of your iTunes' music library you can see here:

iTunes music master library

For example, english users should use nehm get -i Music, russian users - nehm get -i Музыка.

License

MIT

nehm's People

Contributors

n10v avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.