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

Jonathan Matthew's avatar
Jonathan Matthew committed
4
This is Rhythmbox version 2.99.1. 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:
11
  http://www.gnome.org/projects/rhythmbox/
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
Rhythmbox is developed primarily using gnome cvs. To get a copy
19
of the latest development tree, see this web page:
20
http://www.gnome.org/projects/rhythmbox/development.html
Jorn Baayen's avatar
Jorn Baayen committed
21
22
23
24

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

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

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:

38
   - GStreamer version
Jorn Baayen's avatar
Jorn Baayen committed
39
40
41
42
   - Available GStreamer plugins (run gst-inspect with no arguments)
   
  And anything else you think is relevant.

Colin Walters's avatar
Colin Walters committed
43
44
* 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
45
  by running "rhythmbox -d" from a console. It will output lots of debugging
Colin Walters's avatar
Colin Walters committed
46
  information, the last file mentioned in the console output will quite likely
47
48
  correspond to the file causing the crash. If you want to save the debug log
  to a file, use "rhythmbox -d 2> debug.log".
Colin Walters's avatar
Colin Walters committed
49

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

Jonathan Matthew's avatar
Jonathan Matthew committed
53
  $ gst-launch-0.10 playbin2 uri="file:///path/to/my/musicfile.ogg"
Colin Walters's avatar
Colin Walters committed
54

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

57
  $ gst-launch-0.10 -t uridecodebin uri=file:///path/to/my/musicfile.ogg  ! fakesink
Colin Walters's avatar
Colin Walters committed
58
59
 
  Just replace /path/to/my/musicfile.ogg with some sound file in the 2 commands
60
  above.
Colin Walters's avatar
Colin Walters committed
61

Jorn Baayen's avatar
Jorn Baayen committed
62
63
64
65
* How to reproduce the bug.

* 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).
66
67
  See http://live.gnome.org/GettingTraces for more information on getting
  stack traces.
Jorn Baayen's avatar
Jorn Baayen committed
68

69
Development
Jorn Baayen's avatar
Jorn Baayen committed
70
71
=======

72
See the HACKING file.
73