https://github.com/hukka/cplay

cplay is a curses front-end for various audio players
https://github.com/hukka/cplay

Last synced: about 2 months ago
JSON representation

cplay is a curses front-end for various audio players

• Host: GitHub
• URL: https://github.com/hukka/cplay
• Owner: hukka
• License: gpl-2.0
• Archived: true
• Created: 2011-03-01T20:34:59.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2018-07-10T16:27:46.000Z (about 6 years ago)
• Last Synced: 2024-05-19T23:37:10.317Z (4 months ago)
• Language: Python
• Homepage:
• Size: 118 KB
• Stars: 7
• Watchers: 3
• Forks: 2
• Open Issues: 10
• Metadata Files:
  • Readme: README
  • Changelog: ChangeLog
  • License: LICENSE
  • Authors: AUTHORS

Awesome Lists containing this project

README

        
DEPRECATION NOTICE:

This repo hasn't gotten any love in a long, long time. You might be interested in trying andreasvc/cplay or xi/cplay-ng

Description:

        cplay is a curses front-end for various audio players. It aims

        to provide a power-user-friendly interface with simple filelist

        and playlist control. cplay is written in Python and can use

        either pyncurses or the standard curses module.

Requirements:

    - python                  http://www.python.org/

    - pyalsaaudio (optional)  http://pyalsaaudio.sourceforge.net/

                                For Alsa mixer support

    - mutagen     (optional)  http://code.google.com/p/mutagen/

                                For metadata support (IDv3 etc.)

    - magic       (optional)  http://www.darwinsys.com/file/

                                For better filetype recognition

For playback either install mplayer (recommended): http://www.mplayerhq.hu/

or one or more of the following players:

    - mpg321                  http://sourceforge.net/projects/mpg321/

    - ogg123                  http://www.vorbis.com/

    - mpg123                  http://www.mpg123.org/

    - splay                   http://splay.sourceforge.net/

    - madplay                 http://www.mars.org/home/rob/proj/mpeg/

    - mikmod                  http://www.mikmod.org/

    - xmp                     http://xmp.sf.net/

    - sox                     http://sox.sf.net/

    - speex                   http://www.speex.org/

Installation:

        make install

Usage:

        cplay [-d ] [-n] [-r] -[R] [ file | dir | playlist ] ...

        -d  Enable debugging output to .

        -n  Start in restricted mode: No shell commands, changing directory,

            goto, or saving playlists.

        -r  Start in repeat mode.

        -R  Start in random mode.

        When in doubt, press 'h' for a friendly help page.

Configuration:

        If you would like to change options passed to the actual players

        just edit the PLAYERS list in the cplay script or put the PLAYERS

        definition in either ~/.cplayrc or /etc/cplayrc. If one of these

        files is available, it is executed by cplay before initialization.

        Macros are defined using the MACRO dictionary, where the key is

        a key and the value is a string of cplay input. For example, the

        following would make ,d delete tagged (or current) files:

                MACRO['d'] = '!rm "$@"\n'

        Note, there is currently no version control for the rc-file!

Miscellaneous:

        A playlist can contain URLs, but the playlist itself will

        have to be local. For mpeg streaming, splay is recommended.

        It is also possible to pipe a playlist to cplay, as stdin

        will be reopened on startup unless it is attached to a tty.

        Remote control is available via /var/tmp/cplay_control-$USER.

        Create this with mkfifo and see lircrc for examples.

        The shell command gets the full path of either all tagged

        items or the current item as positional arguments.