Developers
Source code
The most recent revisions are available from the Git repository:
git clone https://unplug.dbatley.com/code/unplug/
Alternatively, browse the source code directly on the website.
You can help
UnPlug is Open Source: if you'd like to contribute some source code then just email to unplug@dbatley.com.
You can also help by working out how to get media off websites. If you can make it into our special rules.xml format, that's excellent; otherwise just send it as human-readable instructions, or however else you like.
Another thing which is really useful is network traffic when fetching media from websites which limit access by country.
Overview
UnPlug is organized as follows:
- overlay: Files for integration into firefox.
- rules.xul: A language and platform independent xml file containing details of how to search for media (view). You can write your own rules to support more sites.
- search: A parser for rules.xul which searches pages for media and may download extra pages as needed (eg: xml files loaded by flash
- display: The popup window which displays the output from the search (used to be called "searchpage".
- display/download: The methods of downloading search result entries (eg: using firefox's "save-as" method or invoking a tool like DtA) is being spun-off from the display code, and lives here.
A good way to see what's happening is to look at the error console (tools menu), where traffic between the search and display layer (plus errors from elsewhere) and dumped out.
In the long-term, the interface will become stable and allow parts of the system to be replaced (for example, if other ways of displaying the results are wanted).