aboutsummaryrefslogtreecommitdiffstats
path: root/README
blob: b331b13007f35911376b7b7a33bf7e2f6ed08723 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
mb-desktop-xine README - Matthew Allum - <mallum@handhelds.org>


Introduction
===

mb-desktop-xine is a matchbox-desktop plugin that allows you to browse
and play movies and music. Its in pretty early stages and should
probably be considered alpha software - its rough around edges. 

It grew out of a need to urge to run matchbox on my TV ( via mini-itx
box ) and make it do something useful. Its alot more basic than
something like MythTV but has less dependencies.

Install
===

Make sure you have a recent matchbox-desktop ( 0.8+ ) and libxine installed.

Then do the usual; 

% ./configure 
% make
% make install 


Configuring
===

To get matchbox-desktop to load the module you need to add a line for
the module to you mbdesktop_modules file ( from matchbox-desktop install ).

The line should contain the location of your installed module ( prefix/share/matchbox/desktop/modules/xinebrowser.so ) and then a full path to a comfiguration file. I have for example;

% cat ~/.matchbox/mbdesktop_modules

/usr/local/share/matchbox/desktop/modules/imgbrowser.so /home/mallum/Desktop/Media/pictures
/usr/local/share/matchbox/desktop/modules/xinebrowser.so /home/mallum/.matchbox/mbxine.desktop


The conference file referenced is a .desktop file and should look
something like;


[Desktop Entry]
MoviePath=/mnt/media/movies
MusicPath=/mnt/media/music
PlaylistsPath=/mnt/media/playlists
VideoDriver=xv
VizPlugin=goom
RadioPath=/home/mallum/.matchbox/radio

This is needed to tell the module where to find your various media
files and to tweak various settings.

Note, you probably only need to change the various path keys, the
defaults for everything else should be fine.

Heres a list of know keys;

- 'MoviePath'     
   Set it to a full path where all your music files are. 
   defualts to '/movies'. 

- 'MovieFolderName'
   Sets the name of the 'Movie' folder. 
   defualts to 'Movies'.

- 'MusicPath'
   Set it to a full path where all your music files are. 
   defualts to '/music'. 

- 'MusicFolderName'
  What to name the Music folder

- 'RadioFolderName'
  What to name the Radio folder

- 'DrivePath'
   Where you dvd/cdrom os.
   defaults "/dev/dvd";

- 'VizPlugin'

  Xine visualisation plugin to use.
  defaults to 'goom' 

- 'VideoDriver'

  Xine video driver to use.
  defualts to 'auto'

- 'AudioDriver'

  Xine audio driver to use.
  defaults to 'auto'

- 'RadioPath'

  Path to radio .desktop files ( see below )
  defaults to '/radio'

- 'PlaylistsPath'

  Path to playlists
  defaults to '/playlists'

- 'ThumbnailVideo'

  Thumbnailing videos is call, but can cause crashes :( so you may want to
  set this to false.
  
  defaults to 'true'

- 'ForceXShmForVisuals'

  I had some problems with xine and goom playing under Xv on my box, So
  I added this. 

  defaults to 'false' 


Once this is setup, start the matchbox-desktop and you should be all set 
togo. Check the main matchbox manual and themeing howto for further 
tweaking of things like icon sizes, theme etc. 


Adding Radio stations
===

Radio stations are just .desktop files added to your Radio
directory containing a Mrl ( or url ) for the radio stream. 

Heres an example;

[Desktop Entry]
Mrl=mmsh://ms2.capitalinteractive.co.uk/xfm_high
Name=XFM
Icon=xfm.png

The Icon entry is optional.


Adding Playlists
===

You can add these with the extension .txt or .m3u to your Playlist directory.

The expected format is simple text files with one entrys per line
containing a path to a music file ( This is basically .m3u format ).
Make sure the paths are either full absolute or relative to you Music
root.


Remote Control/Keys Setup
===

mb-desktop-xine uses the following keys for control;

( NOTE: there is a program included with lirc which you can use to make
        your remote send x key envents - this is what I use. Alternatively
        if the keys dont match what you want use xmodmap or patch 
        mb-desktop-xine source. I hope to make th ekeys configurable in the 
        future. )


Home:
        DVD - goto menu.
i:
            - Show infomation on current playing media. 

m:
	    - toggle volume mute

+:
	    - volume up

-:
	    - volume down

Arrow Up:
   Browsing - naviagtion
   playback - volume down
        DVD - menu operation.

Arrow Down:
   Browsing - naviagtion
   playback - volume up
        DVD - menu operation.
     

Arrow Right:
   Browsing - naviagtion
      Music - play next track ( except radion )
      Movie - advance forward
        DVD - menu operation.


Arrow Left:
   Browsing - naviagtion
      Music - play prev track ( except radion )
      Movie - advance backward
        DVD - menu operation.
	  
space:
            - pause

f:
	    - Fast forward ( if possible )

Return / Enter: 
   Browsing - activate selected item ( eg play ) 
        Dvd - menu selection.    
   playback - exit