README 2.73 KB
Newer Older
Jorn Baayen's avatar
Jorn Baayen committed
1
2
3
General Information
===================

4
This is Rhythmbox version 0.8. Rhythmbox is your one-stop multimedia
Colin Walters's avatar
Colin Walters committed
5
application, supporting a music library, multiple playlists,
Jorn Baayen's avatar
Jorn Baayen committed
6
7
8
9
10
internet radio, and more.

Rhythmbox is free software, licensed under the GNU GPL.

The official web site is:
Colin Walters's avatar
Colin Walters committed
11
  http://web.rhythmbox.org/
Jorn Baayen's avatar
Jorn Baayen committed
12
13

Information about mailing lists can be found at:
Jorn Baayen's avatar
Jorn Baayen committed
14
  http://lists.gnome.org/mailman/listinfo/rhythmbox-devel
Jorn Baayen's avatar
Jorn Baayen committed
15
16
17

Our IRC channel is #rhythmbox on GIMPnet (irc.gimp.org).

18
19
20
21
Rhythmbox is developed primarily using the arch revision control
system, specifically the "tla" implementation.  To get a copy
of the latest development tree, see this web page:
http://web.rhythmbox.org/development.html
Jorn Baayen's avatar
Jorn Baayen committed
22
23
24
25

Installation
============

Colin Walters's avatar
Colin Walters committed
26
See the files INSTALL.quick and INSTALL.
Jorn Baayen's avatar
Jorn Baayen committed
27
28
29
30
31
32
33
34
35
36
37
38

How to report bugs
==================

Bugs should be reported to the GNOME bug tracking system.
(http://bugzilla.gnome.org, product rhythmbox.) You will need to create an
account for yourself.

In the bug report please include:

* Information about your system. For instance:

39
   - GStreamer version (or Xine version if you're using the Xine backend)
Jorn Baayen's avatar
Jorn Baayen committed
40
41
42
43
   - Available GStreamer plugins (run gst-inspect with no arguments)
   
  And anything else you think is relevant.

Colin Walters's avatar
Colin Walters committed
44
45
46
47
48
49
* If rhythmbox crashes when you try to import a folder full of music files
  to your library, you can pinpoint the exact file causing the crash
  by running rhythmbox -d from a console. It will output lots of debugging
  information, the last file mentioned in the console output will quite likely
  correspond to the file causing the crash.

Colin Walters's avatar
Colin Walters committed
50
* Before you report a bug, it will be useful to know if GStreamer works.
Colin Walters's avatar
Colin Walters committed
51
  If you have playback issues, try running this command:
Colin Walters's avatar
Colin Walters committed
52

53
  $ gst-launch-0.8 gnomevfssrc location=/path/to/my/musicfile.ogg ! spider ! volume ! audioscale ! audioconvert ! $(gconftool-2 -g /system/gstreamer/0.8/default/audiosink)  
Colin Walters's avatar
Colin Walters committed
54

Colin Walters's avatar
Colin Walters committed
55
56
57
58
59
60
61
  If you have troubles importing a specific file to your library, try running:

  $ gst-launch-0.8 filesrc location=/path/to/my/musicfile.ogg ! typefind ! spider ! audio/x-raw-int ! fakesink
 
  Just replace /path/to/my/musicfile.ogg with some sound file in the 2 commands
  above.

62
  You might also want to try the monkey-media tests/test-cmdline program.
Colin Walters's avatar
Colin Walters committed
63

Jorn Baayen's avatar
Jorn Baayen committed
64
65
66
67
68
69
70
71
72
73
* How to reproduce the bug.

  If you can reproduce the bug with one of the programs in tests/, that
  will be most convenient.  Otherwise, please include a short test program
  that exhibits the behavior.  As a last resort, you can also provide
  a pointer to a larger piece of software that can be downloaded.

* If the bug was a crash, the exact text that was printed out when the
  crash occured, and a trace (which can be obtained by using gdb or bug-buddy).

74
Development
Jorn Baayen's avatar
Jorn Baayen committed
75
76
=======

77
See the HACKING file.
78
79

arch-tag: The typical project user README doc