Permalink
Browse files

*** 1.49 released ***

	* README, cplay.1:
	- document restricted mode
  • Loading branch information...
1 parent f13d1a2 commit e6224de0d056beab9f16ae8d203cecebd7939bdc Ulf Betlehem committed with Dec 5, 2003
Showing with 113 additions and 61 deletions.
  1. +7 −0 ChangeLog
  2. +3 −0 Makefile
  3. +7 −6 README
  4. +47 −49 TODO
  5. +1 −1 cplay
  6. +10 −4 cplay.1
  7. +35 −0 cplay.list
  8. +3 −1 cplayrc
View
@@ -1,3 +1,10 @@
+2003-12-05 Ulf Betlehem <flu@iki.fi>
+
+ *** 1.49 released ***
+
+ * README, cplay.1:
+ - document restricted mode
+
2003-11-08 Ulf Betlehem <flu@iki.fi>
*** 1.49pre4 ***
View
@@ -16,3 +16,6 @@ recursive-all recursive-install recursive-clean:
for i in $(SUBDIRS); do \
(cd $$i && make $(ENV) $${target#recursive-}); \
done
+
+cplayrc: cplay
+ awk '/^PLAYERS/ {p=1} /^$$/ {p=0} {if (p==1) {print}}' cplay > cplayrc
View
@@ -22,25 +22,26 @@ Requirements:
- pyvorbis (optional) http://www.duke.edu/~ahc4/pyogg/
- xmp (optional) http://xmp.sf.net/
- sox (optional) http://sox.sf.net/
+ - speex (optional) http://www.speex.org/
Installation:
make install
Usage:
- cplay [-rRv] [ file | dir | playlist ] ...
+ cplay [-nrRv] [ file | dir | playlist ] ...
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 /etc/cplayrc. If this file
- is available it is executed by cplay before initialization.
+ 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.
- Note, there are currently no version control for this file!
+ Note, currently there is no version control for the rc-file!
Miscellaneous:
View
@@ -1,98 +1,97 @@
+Keymap
+------------------------------------------
+Filelist: _b_def___________r____w_y_ ABCDEF_HI__LMNOP_RS__VWXYZ
+Playlist: ab__ef________o_________y_ ABC_EF_HI__L_NOP_____VW_YZ
+Overload: ____________m_____s_______ __________________________
+
TODO
------------------------------------------
-5 - document <, >
-x - wma (mplayer?)
+x - external mixer framework (MIXERS list?)
+x - select player based on magic?
+1 - use 00:00:00 instead of 00h 00m 00s ?
+x - remove inc_volume and dec_volume when control fifo takes args
+4 - support wma (via mplayer?)
+3 - support musepack
+3 - support midi players
+3 - support flac (command line player?)
+3 - support xmms?
x - replace current playlist (useful when streaming?)
x - browse bookmarks?
-x - use "file" to both get mime and bitrate info?
-x - backspace does not work on gentoo?
+3 - use "file" to both get mime-type and bitrate info?
+2 - backspace does not work on gentoo?
x - index-mode: group/sort/search by ctime, filename, metadata, etc.
x - screen title patch
-x - expand 2 or more dirs mode for filelist?
-x - musepack
-x - don't require both ID3 and pyogg for one of them to work
-x ? title/status realtime only from playlist
-x - progress bar not always reset?
-x - call update_status() from poll()
+x - tree view patch: expand 2 or more dirs mode for filelist?
+4 - don't require both ID3 and pyogg for one of them to work
+ - how to enable the metadata viewpoint?
x - get_tag() is messy
-x - don't try to write m3u to search results path
-x - shell from playlist?
+5 - don't try to write m3u to search results path
+4 - don't write dir/.m3u files for w + enter
+x - search results mode vs path
+x - shell from playlist? (requires new tab-completion?)
3 - incremental filter command 'f' like *amp 'j'
+4 - optionally show all files in a dir
2 - show alternatives in filelist for ambiguous completion?
1 - :commands?
x - macros / bind user commands
-2 - optionally show all files in a dir
3 - center current line (requires one-line scrolling)
x - shell prompt could show number of args? (tagged entries)
-x ? change cwd for shell commands (what about "search results"!?)
+5 - change cwd for shell commands (crash if "search results"!?)
x - embed search command in pathname to view in filelist? (bookmark results)
- /path/name?search=args or /path/name?index=args
- will allow bookmarks, except for refined searches?
+ - don't allow bookmarking in search results (mode)
x - command-line history? (now cursor-up cancels)
-x - index based on metadata database (manual update and batch cplay -u dir?)
-x - virtual index-dirs
x - persistence: save state on exit?
-x - save current config to conf/rc file?
-x - delete playlist entries is too slow
- - try creating a new list from non-tagged items?
-x - rename/rethink app.kludge
x - replace help window with generic show file window (move help -> file)
x - shuffle & sort tagged entries only?
x - searching for empty string not currently possible with /
x - make isearch use regexes?
-x - make could compile and run a small program that figures out
- ioctl numbers on different OS/architectures.
x - sanity check: (pause or stopped) and seek => play?
-x - add status message for unbound keys / commands
-x - use >, < to scroll window sideways?
-x - number of dirs to hide in vp_pathname. change with >, <
-x - use reverse logic: number of parent dirs to show with >, <
+4 - add status message for unbound keys / commands
+x - change number of parent dirs to show
.. makes pathname viewpoint obsolete?
x - search/tag regex/... on str(entry) or entry.vp() ?
-1 - use & for delayed commands?
+ .. currently sorting by vp, tagging by str and searching by str
2 - wait 0.5s between subsequent next/prev. NOT before starting player!
- .. or pause current player immediately on next/prec commands?
+ .. or pause current player immediately on next/prev commands?
.. compare with repeating enter?
3 - rc-file with
1. player configs
2. metadata viewpoint format
3. pathname viewpoint number of dirs to show (command also?)
4. persistent bookmarks
-3 - enter opens m3u as virtual dir in filelist
-3 - support midi players
-3 - support flac (command line player?)
-x - support xmms?
-3 - better madplay support
-4 - restricted mode (disable bang)
-4 - pls-playlist TITLE support
-3 - programmable delay between songs (useful for MD synchronized recording)
-0 - improve isearch using bookmarks for previous position?
-4 - error msg when following broken links?
+4 - enter opens playlists as virtual dir in filelist
+5 + restricted mode (bang, write m3u, open path, soft chroot)
+4 - pls-playlist TITLE and LENGTH support
+3 - programmable delay between songs (useful for synchronized recording)
+1 - improve isearch using bookmarks for previous position?
+4 - error msg when following broken links (what?)
4 - don't block on slow commands (eg. listdir / add dir / recursive search)
-3 - better input support (readline?)
2 - fast Esc (not possible with keypad?)
2 - hide cursor after SUSP & CONT cycle
4 - metadata info page
-4 ? chdir(..) should behave like Backspace
4 - try small screen layout patch
2 - check against old ogg.and.mp3.info.patch for missing features
3 - use i to toggle *info window?
5 - recursive search should save bufptr of prev dir
-4 - revert sorting change -> always sort according to viewpoint
-3 - clean up app.player.is_stopped() mess
+3 - clean up app.player.is_stopped() and app.kludge mess
2 - which -> WHICH (upcase global functions?)
3 - howto select player for streaming http://ip:port urls?
misc thoughts
------------------------------------------
+- use & for delayed commands?
+- import on demand wrapper?
+- mark or delete duplicate or no-longer existing playlist entries
+- locate and jump to (show) current playlist entry in the filelist
- fork and exec /bin/sh and select on pipe for command completion?
- use C as a shortcut for untag/clear all?
- suspend + resize + continue -> should resize
-- rc-file
- sort search results
-- magic
- dynamic help page?
+- better input support (readline?)
- toggle header / small screen mode (treshold?)
- randomly play albums (groups / hierarchical playlist)
- delwin before/in/after resize?
@@ -101,20 +100,19 @@ misc thoughts
- dust off cddb patch?
- filtered point of view (obsoleted by recursive searching?)
- mark filelist entries already in playlist
-- support cd-players
-- sideways scrolling?
- alternative scrolling method
- metadata editor?
- reread dir => search for current entry
- support alsaplayer, xmp, others?
+- support cd-players?
- delayed play or mark as next command (play after current is finished)
- use 'N' to mark as next?
-- reset progress when changing song? (what?)
+- reset progress at end of playlist? (or when changing song?)
- restore xterm title (not possible with aterm, rxvt, etc?)
- mpg123 gives jumpy progress info for vbr files (averaging filter?)
- should there be another way to start playing the playlist
from the beginning than "next track"? (and Tab+Enter)
-- new and more vi-friendly keymap
+- more vi-friendly keymap?
- numerical arguments?
- n and N could correspond to next and previous
- f and b could select next and previous track?
@@ -124,5 +122,5 @@ misc thoughts
- show progress-counter while streaming?
- support slang?
- fade in/out mode? (a la repeat/random)
-- crossfade mode (hardly)
+- crossfade mode
- is Enter and cursor position logical / intuitive? (absolutely)
View
@@ -1,7 +1,7 @@
#!/usr/bin/env python
# -*- python -*-
-__version__ = "cplay 1.49pre4"
+__version__ = "cplay 1.49"
"""
cplay - A curses front-end for various audio players
View
@@ -34,9 +34,11 @@ as positional parameters, which means that "$@" might be useful.
.PP
Currently, the following audio formats are supported: MP3 (through
mpg321, splay, mpg123 or madplay), Ogg Vorbis (through ogg123), and
-various module-formats (through mikmod).
+various module-formats (through mikmod and xmp).
.SH OPTIONS
+.IP \fB\-n
+Enable \fIrestricted\fI mode
.IP \fB\-r
Toggles playlist \fIrepeat\fP mode
.IP \fB\-R
@@ -53,15 +55,19 @@ Toggles PCM and MASTER (default) volume control
.BR madplay (1),
.BR mikmod (1),
.BR xmp (1),
-.BR play (1)
+.BR play (1),
+.BR speexdec (1)
.SH FILES
.PP
.I /var/tmp/cplay_control
-- The optional remote control fifo.
+- Optional remote control fifo.
.I /etc/cplayrc
-- The optional configuration file.
+- Optional configuration file.
+
+.I ~/.cplayrc
+- Optional configuration file.
.SH AUTHOR
.PP
View
@@ -0,0 +1,35 @@
+# cplay list file
+# tested with epm 2.5 and cplay 1.48
+
+# Manpage extensions...
+$MAN1EXT=1
+
+# Directories...
+$prefix=/usr/local
+$bindir=${prefix}/bin
+$confdir=/etc
+$docdir=${prefix}/doc/cplay
+$mandir=${prefix}/man/man1
+
+# Product information
+%product cplay
+%copyright GPL
+%vendor Ulf Betlehem <flu@iki.fi>
+%license COPYING
+%readme README
+%description cplay, a curses front-end for various audio players.
+%version 1.48
+%packager Giuseppe "Cowo" Corbelli <cowo@lugbs.linux.it>
+
+# Executables
+%system all
+f 0555 root sys ${bindir}/cplay cplay
+# Doc
+f 0444 root sys ${docdir}/README README
+f 0444 root sys ${docdir}/TODO TODO
+
+# Man pages
+f 0444 root sys ${mandir}/cplay.${MAN1EXT} cplay.1
+
+#Configuration
+f 0644 root sys ${confdir}/cplayrc cplayrc
View
4 cplayrc 100755 → 100644
@@ -6,5 +6,7 @@ PLAYERS = [
TimeOffsetPlayer("madplay -v --no-tty-control --display-time=remaining -s %d %s", "\.mp[123]$"),
NoOffsetPlayer("mikmod -q -p0 %s", "\.(mod|xm|fm|s3m|med|col|669|it|mtm)$"),
NoOffsetPlayer("xmp -q %s", "\.(mod|xm|fm|s3m|med|col|669|it|mtm|stm)$"),
- NoOffsetPlayer("play %s", "\.(aiff|au|cdr|mp3|ogg|wav)$")
+ NoOffsetPlayer("play %s", "\.(aiff|au|cdr|mp3|ogg|wav)$"),
+ NoOffsetPlayer("speexdec %s", "\.spx$")
]
+

0 comments on commit e6224de

Please sign in to comment.