oscp Wiki

multiplatform, small and handy audio/video player with network remote

Status: Beta

Brought to you by: kot_czarny

Home

Authors:

<html><head>oscp manual</head><body>

oscp manual (c) ariel/KotCzarny

1. Description

multiplatform player for (almost) any a/v format and network streams (using libav/ffmpeg and
others), now with pygtk GUI

- plays multiple audio formats lossy and lossless (mp3/ogg/aac and friends)

- plays multiple game/tracker formats

- plays network streams (http://, mms://, rtsp://)

- playlists, favourites, one-key recursive playlists

- effects: based on sox-14.4.2, 10-band equalizer, flanger, earwax, contrast(compress), reverb, overdrive, oops(karaoke)

- remembers play position

- quick fav dir keys

- unzip/unrar support

- path based browse/search (media libraries are overrated)

- ncurses ui with easy navigation (with mouse support)

- network interface for remote commands. gtk+ and pygtk gui on local or remote device. built-in server for remote control

- classic winamp skin support (with ability to load random one)

- lirc (remote) support

- http scraper mode (loads http page, parses it for playable links and plays them)

- multiplatform (you can control maemo core from pc remote and pc core from maemo remote)

- small and lightweight (almost no dependencies, needs only platform based audio library alsa/oss/esd/libao/pulse)

- last.fm/libre.fm scrobbler (last.fm broken since spotify takeover)

- lirc (remote) support

- many more little bits that make your audio experience smooth and comfortable

3. Usage

- cmdline/ncurses: run it (./oscp or /opt/oscp/bin/oscp or wherever you have put the binary)
in terminal and use cursor keys to navigate your folders/files. By default LEFT goes to parent
dir, RIGHT enters dir/playlist or plays the file.

- gui: after starting gui, it tries to connect to last used core. if it doesnt find one, you can
start it by pressing gears icon (assuming 'oscp' is in your path) or connect to some already
running one ('computers' icon). then use it in the same way as ncurses one (most keys should be
the same)

4. Tips & tricks:

- check effects: shift-E - eq, shift-F - flanger, shift-V - reverb, shift-C - contrast (bumps
volume without clipping), shift-W - earwax, shift-K - karaoke, shift-O - overdrive

- mrl (make-recursive-list): press ';' to recursively add all known files, starting from
current directory

- run it in daemon mode (-d 1 -L 44322) on a machine connected to your stereo, then use remote
gui to control it from anywhere

5. Defaults

default keybindings (configurable in config too):

quit: q, stop: \, pause: p, prev: [, next: ],

rwnd: ',', ffwd: '.', vol-: -, vol+: =,

left (go parent): 'LEFT', right(play/enter): 'RIGHT', up: 'UP', down: 'DOWN',

pg-up: 'PGUP', pg-down: 'PGDOWN', home: 'HOME', end: 'END',

copy_to_fav: 'INSERT', delete_file: 'DELETE', make_recursive_list: ;,

go to fav dir/list: [0..9], set dir as fav: shift-[0..9],

repeat: r, shuffle: s, shuffle2: S, vids: e

config: ~/.oscp/oscp.conf

cmdline usage: oscp options path

        -A <str>        audio dev (fe. pulse sink or libao "dev" key)

        -a <0/1>        autoplay off/on

        -s <0/1/2>      shuffle mode

        -r <0/1/2>      repeat off/all/single track

        -E <0/1>        play vids off/on

        -t <0/1>        display remaining time instead of current

        -f <0/1/2>      fullpath display

        -v <0/1/2>      software volume (off/exponential/linear)

        -V <0..100>     set volume

        -l <0/1>        use lineart compatible/full

        -S <0/1>        scrobble off/on

        -L <1..65536>   listen on TCP port for remote commands

        -N <str>        net acl (ip/mask space separated, ex:

                        "127.0.0.1 192.168.1.0/16 2.3.4.5")

        -d <0/1>        daemonize (disable ui and fork to background)

        -T <str>        dev type

        -P <0/1>        headphone mode, pause when hp unplugged

                        (needs dev type set to n900)

        -F <str>        fav save path

        -M <str>        midi sound patch directory

        -m <str>        midi sound patch config file

        -C <str1> <str2>        convert file1 into WAV (file2)

        -H              show supported formats

        -h              this help (duh)

6. Formats

- slave-libav: based on libav (Lavc56.1.0,Lavf56.1.0,Lavr2.1.0,Lavu54.3.0), formats: mp3, wav, ogg, flac, alac, ape, mpc, aac, m4a, mp2, wv, wma, ra, aif, avi, mpg, flv, mpeg, mp4, m4v, mkv, wmv, asf, mov, rm

- slave-xmp: based on libxmp-4.4.1, formats: mod, med, xm, it, s3m, 669, abk, ac1d, amf, dbm, di, digi, dmf, dtm, emod, eu, far, flx, fnk, gdm, j2b, kris, lax, liq, m15, mdl, mfp, mgt, mmd0, mmd1, mmd2, mmd3, mtm, mtn, mtp, okt, okta, psm, pt36, ptm, rtm, sfx, sfx13, sfx2, stm, stim, stx, ult, umx, wow

- slave-fc14: based on libfc14audiodecoder-1.0.3, formats: fc, fc13, fc14, smod

- slave-gme: based on gme-git (0x601), formats: ay, gbs, gym, hes, kss, nsf, nsfe, spc, vgm, vgz

- slave-asap: based on asap-3.2.0, formats: sap, cm3, cmc, cmr, cms, dmc, dlt, mpd, mpt, rmt, tm2, tm8, tmc, fc

- slave-sc68: based on libsc68 3.0.0.692M, formats: sc68, sndh, snd

- slave-sid2: based on sidplay-libs-2.1.1, formats: sid, psid, rsid, mus

- slave-flod: based on c-flod-4.1, formats: bd, bp, bp3, dm, dm2, dmu, dum, dw, fc, fc13, fc14, fc3, fc4, fred, hip, hipc, jb, mug, rh, sfx, sfx13, sfx2, sid2, sid1, smod

- slave-mdx: external: mdxplay, formats: mdx

- slave-timi: based on libwildmidi-git (0.4.1), formats: mid, midi, xmi, hmi, hmp

- slave-ym: based on stsound-1.43, formats: ym

- slave-adplug: based on adplug-2.2.1, formats: a2m, adl, adlib, amd, as3m, bam, cff, cmf, d00, dfm, dmo, dro, dtm, hsc, hsp, imf, jbm, ksm, laa, lds, m, mad, mkj, msc, mtk, rad, raw, rix, rol, sa2, sat, sci, sng, wlf, xad, xms, xsm

- slave-mpl: external: mplayer, formats: same as libav

- slave-uade2: external, formats: aam, adsc, abk, ac1d, ahx, alp, amc, aon, aon8, ast, avp, bp, bp3, bpsm, bd, bds, bsi, bss, chan, cin, cm, core, cust, cus, dat, dh, di, dl, dlm1, dlm2, dln, dm, dm1, dm2, dns, doda, dsc, dsr, dum, dmu, dp, dss, dw, dz, ea, ems, emsv6, eu, ex, fc, fc13, fc14, fc3, fc4, fcm, fp, fred, fw, glue, gmc, gray, hd, hip, hip7, hipc, hn, ims, is, is20, jam, jcb, jcbo, jd, jmf, jo, jpn, jpnd, jpo, jpold, jt, kh, kris, lax, lme, lion, ma, mc, mcmd, mco, mcr, mcs, md, mdat, mdst, mii, midi, mk2, mkii, ml, mmdc, mms, mok, mon, mso, mtp2, mug, mug2, mw, ntp, pap, pc, ps, psa, pt, puma, pvp, qpa, qts, rh, rho, riff, rk, s, s7g, sa, sas, sb, sc, scn, scr, sct, scumm, sdata, sdr, sfx, sfx13, sg, sid1, sid2, sidmon, sjs, sm, sm3, smpro, smus, snk, snx, soc, sog, sonic, spl, sqt, src, ss, sun, syn, synmod, tf, tfmx, tfx, thm, thx, thn, tiny, tme, tpu, tronic, tw, uds, unic, vss, wb, ym, ymst

7. Links

- original oscp's page on TMO - best
place to report bugs and/or ask for new features. also new versions are announced there

- builds for misc. systems -
precompiled for linux x86/x64/arm, cygwin etc.

8. Contact

- either TMO page or ircnet/freenode (#maemo or #osc)