Giter Club home page Giter Club logo

pysc's Introduction

pysc

Soundcloud in your terminal
pysc is a command-line repl interface to Soundcloud.

Installation

To install pysc, simply:

pip install pysc

Or if you're not hip to the pip:

easy_install pysc

Remember that you need to be connected to internet, unless you have a playlist of downloaded songs.

Features

  • Music

    • List of all music genres available
    • Simple navigation using next and prev
    • Sound player pause/resume options
    • Download of Soundcloud downloadable tracks
  • Playlists

    • Playlists management

Usage

Firstly, let you know about the settings.py file. Only two constants are setted up there, they are:

CLIENT_ID = '43b1906ada38f27c8e864c07de04b7b7'
TRACKS_PER_PAG = 50

CLIENT_ID is just the pysc app id inside Soundcloud, you can change it to another app id, but it's pointless. And care if you change it, the id must be recognized by Sondcloud, or pysc won't be able to use its api.

TRACKS_PER_PAG is the number of tracks that will be load in each request. You can set whatever you want in there, pysc will deal with pagination for you, just don't set it to 0.
It just means telling pysc create a new request to Soundcloud in every X tracks listened.

To run the pysc repl, just type pysc

Basic example

$ pysc
welcome to pysc! sound cloud in your terminal ~ powered by soundcloud
type 'genres' to discover, or just 'help' to see available commands
>>> genres
80s ~ Abstract ~ Acid Jazz ~ Acoustic ~ Acoustic Rock ~ African ~ Alternative ~ Ambient ~ Americana ~ Arabic ~ Avantgarde ~ Bachata ~ Ballads ~ Bhangra ~ Blues ~ Blues Rock ~ Bossa Nova ~ Breakbeats ~ Chanson ~ Chillout ~ Chiptunes ~ Choir ~ Classic Rock ...
>>> play chillout
gettings tracks...
now playing 'Heso - Between Space and Time'
>>> next
now playing 'Slipstream'
>>> prev
now playing 'Heso - Between Space and Time'

Commands

  • Core
    • help
      List all available commands
    • about
      See about text
    • exit
      Exit pysc
  • Music
    • genres
      List all music genres
    • play <genre>
      Play genre, for example: play chillout
    • pause, resume
      Pause or resume the sound player
    • prev, next
      Go prev or next track
    • prevpage, nextpage
      Go prev or next page of tracks
    • loop, unloop
      Loop or unloop current track
    • seek <seconds>
      Seek for a track time
    • forwards <seconds>
      Go forwards
    • backwards <seconds>
      Go backwards
    • volume <number>
      Manage volume level

Other commands will be available soon.

Contribute

Fork it and send your pull request, i'll be happy to add your ideas!

License

pysc is licensed under MIT license.
Check it here.

pysc's People

Contributors

ramonsaraiva avatar

Stargazers

 avatar

Watchers

James Cloos avatar  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.