Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Update README and add BSD license

  • Loading branch information...
commit 0b0233c90c11aaa1d5f5acc74cd281f1a5d2a563 1 parent 71cec16
@ttencate authored
Showing with 33 additions and 3 deletions.
  1. +22 −0 LICENSE
  2. +11 −3 README.md
View
22 LICENSE
@@ -0,0 +1,22 @@
+Copyright (c) 2013, Thomas ten Cate
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
View
14 README.md
@@ -2,11 +2,19 @@
`playnext` is a small shell script that helps you watch series, listen to podcasts, or basically do anything to a series of files sequentially.
-The basic operation is as follows: `cd` to a directory that contains some media files, and type:
+The basic operation is as follows: if `/some/directory` contains media files, type
- mplayer "`playnext`"
+ playnext /some/directory
-Instead of `mplayer`, you can of course use any media player or other tool of your choice. The `playnext` script will have remembered the filename of the last episode you played (if any), and output the next one. The backticks make the shell substitute this filename in that place.
+and it will play the first media file in the directory and its subdirectories, using `mplayer`. The next time you run it, it plays the second one, and so on.
+
+After you've once typed `/some/directory` in full, you can afterwards get by with just a substring of the final directory component, e.g. `directory`, `dir` or even `d`:
+
+ playnext dir
+
+As long as this uniquely identifies a previously used directory, it will work.
+
+Instead of `mplayer`, you can of course use any media player or other tool of your choice, using the `-c` option.
Caveats:
Please sign in to comment.
Something went wrong with that request. Please try again.