Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/erickok/transdroid-search
Cross-app torrent search results provider for Android
https://github.com/erickok/transdroid-search
Last synced: 14 days ago
JSON representation
Cross-app torrent search results provider for Android
- Host: GitHub
- URL: https://github.com/erickok/transdroid-search
- Owner: erickok
- License: lgpl-3.0
- Created: 2013-06-22T11:26:42.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2022-04-15T08:07:09.000Z (over 2 years ago)
- Last Synced: 2024-08-01T16:43:58.082Z (3 months ago)
- Language: Java
- Size: 798 KB
- Stars: 152
- Watchers: 23
- Forks: 55
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
transdroid-search
=================
Transdroid Torrent Search is an Android application that provides torrent search results to other Android apps by exposing `ContentProvider`s. Originally part of [Transdroid](https://www.transdroid.org/), it now supplies torrent links for 15+ public and private torrent sites to various torrent-related Android applications.
The latest .apk is available via [transdroid.org/latest-search](https://transdroid.org/latest-search) and code is available under the Lesser GPL v3 license.
Usage
=====
Transdroid Torrent Search provides access to torrent searches on a variety of sites. Instead of providing a search interface itself, it allows Android application to access the data via a content provider.
Getting search results
----------------------
Acquiring search results for a specific query can be as easy as as two lines of code:
```
Uri uri = Uri.parse("content://org.transdroid.search.torrentsearchprovider/search/" + query);
Cursor results = managedQuery(uri, null, null, null, null);
```
The returned `Cursor` can be used in a `ListActivity` or elsewhere. The following fields are available in the returned cursor:
```
String[] fields = new String[] { "_ID", "NAME", "TORRENTURL", "DETAILSURL", "SIZE", "ADDED", "SEEDERS", "LEECHERS" };
```
Customizing search results
--------------------------
A specific site may be queried and the preferred sort order can be given:
```
Uri uri = Uri.parse("content://org.transdroid.search.torrentsearchprovider/search/" + query);
Cursor results = managedQuery(uri, null, "SITE = ?", new String[] { siteCode }, sortOrder)
```
Here, `siteCode` is the code of one of the supported torrent sites. The default is `RARBG`. The `orderCode` is either BySeeders (default) or Combined. Note that no errors are returned when a site or sort order doesn't exist (although they are written to LogCat); a null `Cursor` is returned instead. (This is a limitation of `ContentResolver`s.)
Supported torrent sites
-----------------------
To get a listing of (the codes of) the support torrent sites, including custom RSS sites defined, you may use another provider:
```
uri = Uri.parse("content://org.transdroid.search.torrentsitesprovider/sites");
Cursor sites = managedQuery(uri, null, null, null, null);
```
The returned `Cursor` contains the following fields:
```
String[] fields = new String[] { "_ID", "CODE", "NAME", "RSSURL" };
```
Developed By
============
* Eric Kok (Original developer)
* Steve Garon
* Gabor Tanka
* Eric Taix
* Alon Albert
* John Conrad
* Toon Schoenmakers
* Gabor Foldvari
* Marco Furlando
* Mário Franco
* Martin Piffault
* Colby Brown
* Thomas Riccardi
* and others...
License
=======
Copyright 2010-2019 Eric Kok et al.
Transdroid Torrent Search is free software: you can redistribute
it and/or modify it under the terms of the GNU Lesser General
Public License as published by the Free Software Foundation,
either version 3 of the License, or (at your option) any later
version.
Transdroid Torrent Search is distributed in the hope that it will
be useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with Transdroid. If not, see .
Some code/libraries are used in the project:
* [RssParser](http://github.com/digitalspaghetti/learning-android) (learning-android) by Tane Piper (Public Domain)
* [android-json-rpc](https://code.google.com/archive/p/android-json-rpc/) by alexd (MIT License)
* [Volley](https://github.com/google/volley) by Google (Apache License 2.0)