Metadata-Version: 1.0
Name: blast
Version: 0.3.0
Summary: a simple web-based, multi-platform music/mp3 player written in python, HTML/CSS and javascript
Home-page: http://github.com/kwlzn/blast
Author: kw
Author-email: pypi@onoku.com
License: BSD
Description: =====
        blast
        =====
        
        overview
        --------
        
        blast is a simple web-based, multi-platform music/mp3 player written in python, HTML/CSS and javascript.
        
        
        installation
        ------------
        
        the easiest way to install blast is by using python setuptools "easy_install" command:
        
        ::
        
        $ easy_install blast
        
        you can also install using ez_setup, pip or installing the package directly using setup.py:
        
        ::
        
        $ python setup.py install
        
        
        usage
        -----
        
        ::
        
        $ cd ~/Music
        $ blast
        
        then you can connect to the blast frontend at http://localhost:5000 (or via IP if you're binding externally with -x).
        
        NOTE: if you use flashblock, make sure to whitelist your blast server (otherwise the URLs will simply open as if you clicked them)
        
        
        blast is primarily keystroke driven. here's a list of the available key commands:
        
        ::
        
        v         Play
        c         Toggle Pause
        x         Stop
        j k       Next / Previous Track (Google Reader style)
        n         Next Track (same as j, Google Reader style)
        b z       Next / Previous Track (Winamp Style)
        , .       Reverse or Skip Ahead 1 second
        { }       Reverse or Skip Ahead 5 seconds
        [ ]       Reverse or Skip Ahead 30 seconds
        0         Reset to 0 position
        s         Toggle Shuffle
        m         Toggle Mute
        ?         Toggle Help
        r         Randomize List
        d         Debug Mode
        
        when in doubt, you can also hit the "?" key in the UI to see this same help information.
        
        in addition to key commands, you can click on tracks to play/pause and seek around in tracks by clicking on the duration bar.
        
        platform support
        ----------------
        
        blast is written with portability in mind. currently the server (the blast CLI) should run anywhere that python can be installed (pretty much everywhere) and the UI should run in most browsers. the UI is also known to work under iOS (e.g. for iPhone/iPad playback) - which means you can stream your large computer-based library to your iOS device over wifi.
        
        tested/verified platforms
        ~~~~~~~~~~~~~~~~~~~~~~~~~
        
        - blast server
        - OSX python
        - Cygwin (Windows) python
        - Linux python
        
        - front-end/UI
        - OSX chrome
        - OSX safari
        - OSX firefox
        - iOS safari (iPhone/iPad)
        - Windows chrome
        - Windows firefox
        
        untested, but might work on
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        - Windows python (non-cygwin) and/or ActiveState python
        - Other UNIXs (BSD, Solaris etc) python
        - Windows Internet Explorer
        - Opera
        - Android
        
        open source
        -----------
        
        blast currently leverages the following open source components to speed development:
        
        - Flask (http://flask.pocoo.org/)
        - SoundManager2 (http://www.schillmania.com/projects/soundmanager2/)
        - SoundManager2 Page Player (http://www.schillmania.com/projects/soundmanager2/demo/page-player/)
        - jQuery / jQueryUI (http://jquery.com/, http://jqueryui.com)
        - jQuery Shuffle Plugin (http://yelotofu.com/labs/jquery/snippets/shuffle/)
        - Bootstrap (http://twitter.github.com/bootstrap/)
        - Sticky (http://thrivingkings.com/sticky)
        
        
        contributing
        ------------
        
        blast is open sourced under a simple BSD license. you can find the source code on github:
        
        - https://github.com/kwlzn/blast
        
Keywords: python wsgi web mp3 player javascript html music audio
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: BSD License
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: JavaScript
Classifier: Topic :: Multimedia :: Sound/Audio :: Players :: MP3
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
