This repository has been archived by the owner on Jul 8, 2022. It is now read-only.
/
README
138 lines (89 loc) · 4.24 KB
/
README
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
===========================================================================
Seeking a maintainer
This project is seeking a maintainer. The original authors abandoned
the project, even the web-site is now gone.
I (htgoebel) exhumed the source, split it into sub-projects and
converted it to git. But I'm not able to maintain it. So If you are
interested in this software, I'll happily hand over ownership of the
project.
===========================================================================
===========================================================================
Coherence - a DLNA/UPnP Media Server and Framework for the Digital Living
===========================================================================
Coherence is a framework written in Python,
providing several UPnP MediaServers and MediaRenderers,
and enabling your application to participate in digital living networks.
It is licenced under the MIT licence.
Coherence is known to work with various clients
- Sony Playstation 3
- XBox360
- Denon AV Receivers
- WD HD Live MediaPlayers
- Samsung TVs
- Sony Bravia TVs
and much more...
http://coherence-project.org/wiki/SupportedDevices
As time evolves you will find in this file more detailed
installation and basic configuration instructions.
For now please pardon the inconvenience
and have a look @ http://coherence-project.org
Installation from source
========================
After downloading and extracting the archive or having done a git
clone, move into the freshly created 'Coherence' folder and install
the files with
sudo python ./setup.py install
This will copy the Python module files into your local Python package
folder and the coherence executable to '/usr/bin/coherence'.
http://coherence-project.org/wiki/DocumentationDepartment
Quickstart
==========
To just export some files on your hard-disk fire up Coherence with
an UPnP MediaServer with a file-system backend enabled::
coherence --plugin=backend:FSStore,content:/path/to/your/media/files
A list of all available backends will get printed with::
coherence --help
More information about the backends and their specific configuration:
http://coherence-project.org/wiki/Backends
For a continuous operation the use of a config file is highly recommended.
http://coherence-project.org/wiki/XMLConfig
The config file can be placed anywhere, coherence looks by default for
``$HOME/.coherence``, but you can pass the path via the commandline option
'-c' to it too::
coherence -o /path/to/config/file -more -options
Troubleshooting
===============
If your MediaServer doesn't show up on your client most of the time
networking issue are responsible for that.
- Your system has more than one network interface?
Specify the network interface to use in the config file.
- Add a multicast route, pointing to the proper network interface::
route add -net 239.0.0.0 netmask 255.0.0.0 eth0
- Any firewall on your system?
Writing and integrating your own backend/plugin
===============================================
You can extend the functionality of coherence by writing your own backends/plugins.
- A good starting point for coders, interested in writing their own backend,
would be taking a look at the LolCatsStorage example. The LolCatsStorage
is a very simple and well commented backend. You can find it inside the
backends directory of coherence.
- To integrate your own backend, open the file ``setup.py`` of the coherence
installer and add it to the list of ``entry_points``. Also copy your backend
into the subfolder ``coherence/backends`` of the coherence installer. Finally
start the installation like described above (Installation from source).
Support
=======
First there is our wiki at http://coherence-project.org/. If you find
an error there or think there is some information missing please get
yourself an account and correct that issue. Thx!
Then we have a mailinglist coherence-dev@lists.beebits.net.
You add yourself here:
http://lists.beebits.net/cgi-bin/mailman/listinfo/coherence-dev
And last but not least, there is our irc channel
irc://irc.freenode.net/#coherence
where a lot of other users and most of the developers are around.
..
Local Variables:
mode: rst
ispell-local-dictionary: "american"
End: