Xine

A simple binding to xine-lib.

Example usage:

 import qualified Xine

 main = do

     h <- Xine.open

     sid <- Xine.openStream h "track.mp3"

     Xine.play h sid

Configuration

data XineConf

Xine configuration.

Constructors

XineConf

Fields

audioDriver :: !(Maybe String)

Audio driver. Use Nothing for auto-detection.

videoDriver :: !(Maybe String)

Video driver. Use Nothing for auto-detection.

visualType :: !VisualType

Video output type. Use None to disable video output.

data VisualType

Valid visual types

Constructors

None

X11

X11_2

AA

FB

GTK

DFB

PM

DirectX

CACA

MacOSX

XCB

Raw

Instances

Enum VisualType

Eq VisualType

defaultConf :: XineConf

Default configuration. Audio only.

Handle

data XineHandle

A xine-lib handle.

open :: IO XineHandle

Open a new Xine handle using defaultConf.

openWith :: XineConf -> IO XineHandle

Open a new Xine handle using the supplied XineConf.

close :: XineHandle -> IO ()

Close Xine handle. The handle is invalid after this.

isClosed :: XineHandle -> IO Bool

Test whether the handle is closed.

Streams

You may open multiple streams for playback. Beware, though, that new streams cannot be added once playback has started, so open your streams before using them.

type MRL = String

Media Resource Locator. Describes the media to read from. Valid MRLs may be plain file names or one of the following:

• Filesystem:

file:<path>

fifo:<path>

stdin:/

• CD and DVD:

dvd:/[device_name][/title[.part]]

dvd:/DVD_image_file[/title[.part]]

dvd:/DVD_directory[/title[.part]]

vcd://[CD_image_or_device_name][@[letter]number]

vcdo://track_number

cdda:/[device][/track_number]

• Video devices:

v4l://[tuner_device/frequency

v4l2://tuner_device

dvb://channel_number

dvb://channel_name

dvbc://channel_name:tuning_parameters

dvbs://channel_name:tuning_parameters

dvbt://channel_name:tuning_parameters

dvba://channel_name:tuning_parameters

pvr:/tmp_files_path!saved_files_path!max_page_age

• Network:

http://host

tcp://host[:port]

udp://host[:port[?iface=interface]]

rtp://host[:port[?iface=interface]]

smb://

mms://host

pnm://host

rtsp://host

type StreamId = Int

Identifies an open stream.

openStream :: XineHandle -> MRL -> IO StreamId

Open a new stream for the given MRL.

closeStream :: XineHandle -> StreamId -> IO ()

Close the specified stream.

getCurrent :: XineHandle -> IO (Maybe StreamId)

Get the current stream, if any.

Playback

data SeekArg

Argument for seek.

Constructors

SeekTime Int

SeekPos Int

Instances

Eq SeekArg

Show SeekArg

play :: XineHandle -> StreamId -> IO ()

Start playback.

seek :: XineHandle -> StreamId -> SeekArg -> IO ()

Seek to a position or time in the stream.

Warning: this will crash if xine_trick_mode is not implemented.

stop :: XineHandle -> StreamId -> IO ()

Stop playback.

pause :: XineHandle -> StreamId -> IO ()

Toggle pause.

Information retrieval

data EngineStatus

Engine status codes.

Constructors

Idle

Stopped

Playing

Quitting

Instances

Enum EngineStatus

Eq EngineStatus

Show EngineStatus

data MetaType

Constructors

MetaTitle

MetaComment

MetaArtist

MetaGenre

MetaAlbum

MetaYear

MetaVideoCodec

MetaAudioCodec

MetaSystemLayer

MetaInputPlugin

MetaDiscId

MetaTrackNumber

MetaComposer

MetaPublisher

MetaLicense

MetaArranger

MetaLyricist

MetaConductor

MetaPerformer

MetaEnsemble

MetaOpus

MetaPart

MetaPartNumber

MetaLocation

Instances

Enum MetaType

getStatus :: XineHandle -> IO EngineStatus

Get current engine status.

getMetadata :: XineHandle -> StreamId -> MetaType -> IO String

Get meta data about the given stream.