Replicant

h1. Replicant Wiki

News about the project is available in the "Replicant website":http://replicant.us. You are currently in the Wiki section, which is the user edited section - feel free to contribute by creating an account and editing pages now!

When making edits, please bear in mind that we are a "free software":http://www.fsf.org/about/what-is-free-software project.

h2. Current Status By Phone

* HTC Dream/HTC Magic [[ReplicantStatus#htcdreamhtcmagic|Status]]: Supported (replicant 2.2)

* Nexus One [[ReplicantStatus#nexusone|Status]]: Supported (replicant 2.2)

* Nexus S [[ReplicantStatus#nexuss|Status]]: Work in progress (replicant 2.3)

 Note that if you have a device that is not a Nexus One, an HTC Dream or a Nexus S, adding support for it may be possible, especially if your phone is very similar to a supported one or if you have partial or complete source code for the hardware libraries.

h2. How to install Replicant

* Here's the [[Installation]] page

h2. Replicant usage How-To

* Enable and configure [[ReplicantUSBNetworking]]

h2. FDroid - a libre market application

Replicant Software Center is a fully free software market application to download and manage free software apps on Replicant.

We are using the "F-Droid client":http://f-droid.org/. You can also download a compiled libre apk "here":http://f-droid.org/repo/FDroid_0.11.apk.

By default it downloads libre apps from its own repository. We are working together with our friend Ciaran, the main F-Droid developer, on a Replicant repository.

The applications on the list of all known [[ListOfKnownFreeSoftwareApps| Free Software applications for the Android platform]] should be incorporated into that.

h2. Libre software replacement for non free Google apps

* Android Market -> "FDroid":http://f-droid.org/

* Gmail -> K9

* Google Maps -> "OsmAnd":https://code.google.com/p/osmand/ (best), gvSIG Mini Maps, OSMdroid, "navit":http://wiki.navit-project.org/index.php/Navit_on_Android (offline routing based on osm maps)

* Google Talk -> "CSipsimple":http://code.google.com/p/csipsimple/ (best),  "Beem":http://www.beem-project.com/, "Gibber":https://guardianproject.info/apps/gibber/, [[Sipdroid]], Nimbuzz

* Youtube -> no need for a proprietary app, just browse the mobile version of youtube which uses rstp (no adobe flash)

* Genie Widget (also known as News/Weather widget)  ->  News providers: BBC News or NPR News.   Weather providers: no need for a proprietary app, just browse the mobile version of your favourite weather website.

h2. Replicant Source Code

* The Replicant source code is currently hosted "at gitorious":http://gitorious.org/replicant. For the branch description, see the Builds Howto

* [[How_to_port_Replicant]] to a similar target than the htc dream(the guide assume that your device have a Qualcomm MSM7K "processor"(in reality it's a "SOC":http://en.wikipedia.org/wiki/System_on_a_chip)

h2. How to build Replicant

* Install the [[BuildDependencies]]

h3. Supported phones

h4. Nexus S (replicant 2.3)

* Here's the build howto: [[BuildNexusS]]

* Here's what proprietary libraries and firmwares were shipped on the Nexus S (codename: crespo) and the status of their replacement: [[ProprietaryNexusSLibsReplacement]]

* For a technical overview of Nexus S and a rationale explaining what makes it a better freedom-compliant device, see [[NexusSTechnicalOverview]]

* For Documentation on the preliminary work for freeing its bootloader: [[NexusSBootloader]]

* Status of the free samsung IPC protocol implementation: [[libsamsung-ipc]]

h4. Nexus One (replicant 2.2 and replicant 2.3)

* Here's the build howto: [[BuildNexusOne]]

* Here's what proprietary libraries and firmwares were shipped on the nexusone and the status of their replacement: [[ProprietaryNexusOneLibsReplacement]]

h4. HTC Dream (replicant 2.2)

* Here's the build howto: [[BuildDream]]

* Here's what proprietary libraries and firmwares were shipped on the htcdream and the status of their replacement: [[ProprietaryHtcDreamLibsReplacement]]

h3. Unsupported phones or work in progress

h4. [[GeeksPhone]] One (replicant 2.3)

* Here's the build howto: [[BuildOne]]

* Here's a list of propietary files shipped with the phone: [[PropietaryOneLibsReplacement]]

h2. SDK

* [[HowtoBuildSDK|How to build the SDK]]

h2. Work in progress

*List of tasks to improve Replicant: [[Tasks]] list*

* Adding support for [[AKM8976A]] (dream accelerometer/magnetometer chip) to akmd-free

* Adding support for [[nexusAccoustic|htc accoustic for the nexus one]]

* [[IntroducingReplicantVideo|Introducing Replicant video]]

* Building Replicant on a 64 bit computer without the 32 bit compatibility libs: [[ReplicantNative64BitBuild]] 

h2. Other Wikis

* "Replicant category in [[AndroidWiki]]":http://en.androidwiki.com/wiki/Category:Replicant

h2. IRC

We meet on the IRC channel "#replicant on irc.freenode.net":https://www.jappix.com/?r=replicant%25irc.freenode.net@irc.jappix.com.

h2. Mailing lists

Here's the "mailing list":http://lists.osuosl.org/mailman/listinfo/replicant

h2. GNU/Linux on the HTC Dream

The replicant project is no longer involved with stock GNU/Linux port on the htcdream, that doesn't mean that the port is not developed anymore, it just means that it's done in the SHR project rather than in the replicant one.

h2. Artwork

* See the [[ReplicantArtwork]] page to download Replicant artwork.

h2. Wiki License

* The new wiki editions should be released under the "cc-by-sa":http://creativecommons.org/licenses/by-sa/3.0/ creative commons

* We are [[WikiRelicensing]] the wiki to cc-by-sa 

h2. Credits

* [[People]]