Permalink
Browse files

update site to reflect new erlang codebase

  • Loading branch information...
1 parent c57f87f commit 25df15f39212123cde1961bc626d9aa4477c5e6f RJ committed Oct 12, 2009
Showing with 74 additions and 46 deletions.
  1. +0 −4 api.html
  2. +7 −21 download/index.html
  3. +0 −3 inc/header.html
  4. +4 −7 index.html
  5. +13 −4 resolvers.html
  6. +50 −7 source.html
View
@@ -176,9 +176,5 @@
This will send the correct HTTP headers for mimetype and content-length, and appear like a traditional file download. These URLs can be passed directly to any media player and streamed, or to a flash swf provided it's flash compatible (ie, mp3).
</div>
-<hr/>
-<p>
-Check the <code>playdar_request_handler.cpp</code> for any missing details. There is also an experimental API for enumerating content on your local machine, because it might be nice to use your browser in lieu of a traditional media player, in some cases.
-</p>
</body>
</html>
View
@@ -1,14 +1,15 @@
<!--#set var="title" value="Playdar - Downloads" --><!--#include virtual="/inc/header.html" -->
<h2>Downloads</h2>
+<h3>Build it yourself</h3>
<p>
-Playdar is under active development, but we do have some binaries available.
-If you are able to compile from source, this is recommended.
+Playdar is under active development, your are <strong>strongly encouraged to compile it yourself</strong>
+from the <a href="/source.html">source code</a>.
</p>
<hr/>
-<h3>Binaries / Installers</h3>
-
+<h3>Old, outdated binaries / installers that still work but you should really compile it</h3>
+<i>These binaries are from the legacy c++ codebase, but still work</i>
<h4>Mac (Intel)</h4>
<p>
<a href="/download/Playdar.prefPane-0.1.8.tar.bz2">Playdar.prefPane-0.1.8.tar.bz2</a><br/> </br/>
@@ -26,27 +27,12 @@
<a href="/download/playdar-win-bin-9july09.zip">playdar-win-bin-9july09.zip</a><br/>
</p>
-<h4>Linux</h4>
-<p>
-No packages yet. INSTALL.txt has detailed instructions for ubuntu 9.04, building from source isn't hard.
-</p>
-
-<hr/>
-
-<h3>Building from source</h3>
-<p>
-Get the source from github: <a href='http://github.com/RJ/playdar/tree/master'>git://github.com/RJ/playdar.git</a>.
-</p>
-<p><b>Protip:</b> read the <a href="http://github.com/RJ/playdar/raw/master/INSTALL.txt" target="asd">INSTALL.txt</a> file.</p>
-<p>
-Older version of OS X? Try the <a href="http://dsingleton.co.uk/blog/playdar-os-x-10-4">Compiling Playdar on OS X 10.4</a> guide.
-</p>
-
<hr/>
<h4>Help!</h4>
<p>
-Visit the irc channel (Freenode, <a href='irc://irc.freenode.net/#playdar'>#playdar</a>) or mailinglist and say hi..
+Visit the irc channel (Freenode, <a href='irc://irc.freenode.net/#playdar'>#playdar</a>) or mailinglist and say hi.
+We are mostly in London/Europe timezone, and would be glad to help you get started.
</p>
</body>
</html>
View
@@ -39,6 +39,3 @@
</a>
</h1>
- <span style="position:absolute; left:3; top:0; color:red; font-weight:bold;">
- *** Now using port 60210 - <a href="http://github.com/RJ/playdar/">pull me</a> ***
- </span>
View
@@ -1,9 +1,6 @@
<!--#set var="title" value="Playdar - Music Content Resolver" --><!--#include virtual="/inc/header.html" -->
<p>
-<span style="color:red;">Playdar is under active development. It's considered beta - we'll be packaging a 1.0-RC soon, the external API is stable, the internal API almost. There's plenty to get excited about - please join IRC/the mailing list if you have any questions or comments.</span>
-</p>
-<p>
-Playdar is a music content resolver service - run it on every computer you use,
+Playdar is a <strong>music content resolver</strong> service - run it on every computer you use,
and you'll be able to listen to all the songs you would otherwise be able to
find manually by searching though all your computers, hard disks, online
services, and more.
@@ -12,11 +9,11 @@
Playdar provides a consistent API for accessing any song ever recorded. <a href="/about.html">Learn more...</a>
</p>
<p>
-Got Playdar running? Check the <a href="/demos/">Playdar Tech Demos</a>
+Got Playdar running? Check the <a href="/demos/">Playdar Web Demos</a> and see how web pages can integrate Playdar to take advantage of music you already have.
</p>
<p>
-Playdar is written in C++ using Boost, and licensed under the GPL3.<br/>
-It is 99% rewritten in Erlang under MIT license, and is far more elegant. Update on this soon.
+Playdar is free and Open Source (MIT License), and written primarily in Erlang.<br/>
+You can extend it by writing additional resolvers in any language you like, not just Erlang. <a href="/resolvers.html">Read more..</a>
</p>
<hr/>
View
@@ -24,15 +24,24 @@
Currently the local-files resolver and the LAN resolver are fully supported and built by default. This allows you to find files on your hard disk, and from other machines running playdar on your home network.
</p>
<p>
-There are other scripts and plugins available in the contrib/ directory. An example of an external resolver script (writen in PHP) is the magnatune resolver - this resolves against the free online record label magnatune.com.
+There are other scripts and plugins available in the contrib/ directory. An example of an external resolver script (writen in PHP) is the magnatune resolver - this resolves against the free online record label magnatune.com. There is also a script that resolves against mp3tunes (an online music locker service), and many others.
</p>
<h3>Write your own Resolver Plugin</h3>
<p>
-Writing additional resolver plugins is easy. You have two options:
+To write additional resolvers that find content from other sources you have two options:
<ul>
-<li>C++ dynamically loaded libraries, such as <a href="http://github.com/RJ/playdar/tree/master/contrib/demo-plugin">this simple C++ resolver</a>.</li>
-<li>Any scripting language or other program can be spawned as an external process, which Playdar talks to by writing to stdin and reading stdout. <a href="http://github.com/RJ/playdar/tree/master/contrib/demo-script">demo resolver PHP script</a></li>
+<li>
+ Any scripting language or other program can be spawned as an external process,
+ which Playdar talks to by writing to stdin and reading stdout. You need to parse requests to stdin (JSON objects)
+ and write any results to stdout (also as JSON objects). Playdar does the rest for you.
+ Example: <a href="http://github.com/RJ/playdar-core/tree/master/contrib/demo-script">demo resolver PHP script</a>
+</li>
+<li>
+ Writing a module in Erlang and defining the playdar_resolver behaviour.
+ A simple Erlang resolver looks like this: <a href="http://github.com/RJ/playdar-core/blob/master/playdar_modules/fake/src">fake_resolver (Erlang)</a>.
+ For slightly more complex examples, check the lan or library modules from the <a href="http://github.com/RJ/playdar-core/blob/master/playdar_modules">playdar_modules dir</a>.
+</li>
</ul>
Consider joining the mailing list or IRC if you are writing a resolver, we'd love to hear about it.
</p>
View
@@ -1,23 +1,66 @@
<!--#set var="title" value="Playdar - Music Content Resolver" --><!--#include virtual="/inc/header.html" -->
<h2>Playdar Source Code</h2>
<p>
-Here are the main git trees. Check the network graph on Github to see the contributors.
-
+Check the network graph on Github to see the contributors.
<ul>
<li>
- <a href="http://github.com/RJ/playdar/tree/master">RJ/playdar</a> - the core playdar daemon.
+ <a href="http://github.com/RJ/playdar-core">RJ/playdar-core</a> - the core playdar daemon and modules.
+</li>
+<li>
+ <a href="http://github.com/jwheare/www.playdar.org">jwheare/www.playdar.org</a> - source for www.playdar.org and Javascript library.
</li>
+</ul>
+<h3>Compiling Playdar</h3>
+Playdar compiles and runs on Windows, Mac and Linux. It's primarily tested on Linux and Mac at the moment, but a proper installer for Windows, and packages for Mac and Linux will be created soon.
+<br/>
+To compile, you'll need:
+<ul>
+<li>A recent version of <a href="http://www.erlang.org/">Erlang</a></li>
+<li>GNU Make</li>
+<li><a href="http://developer.kde.org/~wheeler/taglib.html">TagLib</a> ver 1.5+. (for the audio file scanner)</li>
+<li>Boost headers, specifically string.hpp (for the audio file scanner)</li>
+<li>gcc (for the audio file scanner)</li>
+</ul>
+
+Compiling and running should be as simple as
+<pre>$ make
+$ cp etc/playdar.conf.example etc/playdar.conf
+$ $EDITOR etc/playdar.conf
+$ ./start-dev.sh</pre>
+You can manually run the command from the .sh script on Windows, or just use cygwin.
+<br/>
+ <br/>
+From the erl shell you can scan your collection by entering (final '.' is required!):
+<pre>library_dets:scan(resolver:resolver_pid(library_dets), "/path/to/your/music").</pre>
+<br/>
+Check http://localhost:60210/ and you should see Playdar running on your machine.
+<br/>
+ <br/>
+<b>TODO:</b> Better instructions, binary packages.
+
+<h3>Help!</h3>
+<p>
+Visit the irc channel (Freenode, <a href='irc://irc.freenode.net/#playdar'>#playdar</a>) or mailinglist and say hi.
+<br/>
+We are mostly in the London/Europe timezone, and would be glad to help you get started.
+</p>
+
+<hr/>
+
+<h4>Legacy Code</h4>
+Older code that is no longer in use, or requires updates to work with newer versions of Playdar.
+<ul>
<li>
- <a href="http://github.com/jwheare/www.playdar.org/tree/master">jwheare/www.playdar.org</a> - source for www.playdar.org and Javascript library.
+ <a href="http://github.com/RJ/playdar">RJ/playdar</a> - old C++ codebase. The new Erlang version is much more sexy
</li>
<li>
- <a href="http://github.com/mxcl/playdar-prefpane/tree/master">mxcl/playdar-prefpane</a> - a mac wrapper that runs the playdar daemon and creates a prefpane.
+ <a href="http://github.com/mxcl/playdar-prefpane">mxcl/playdar-prefpane</a> - a mac wrapper that runs the playdar daemon and creates a prefpane.
</li>
<li>
- <a href="http://github.com/lozzd/playdarwin/tree/master">lozzd/playdarwin</a> - a windows wrapper that runs the playdar daemon and create a systray icon.
+ <a href="http://github.com/lozzd/playdarwin">lozzd/playdarwin</a> - a windows wrapper that runs the playdar daemon and create a systray icon.
</li>
<li>
- <a href="http://github.com/mokele/spiffdar/tree/master">mokele/spiffdar</a> - source for spiffdar, an XSPF playlist site that uses playdar.
+ <a href="http://github.com/mokele/spiffdar">mokele/spiffdar</a> - source for spiffdar, an XSPF playlist site that uses playdar.
</li>
</ul>

0 comments on commit 25df15f

Please sign in to comment.