Skip to content


Subversion checkout URL

You can clone with
Download ZIP
c:geo - The powerful Android geocaching app.
Java HTML Shell
Branch: master
1 comment

Merge branch 'release'

latest commit 6a29c86b91
@rsudev rsudev authored
Failed to load latest commit information.
.idea Update IntelliJ IDEA configuration
android-support-v7-appcompat downgrade support library to v20
cgeo-calendar crowdin: New translations
cgeo-contacts crowdin: New translations
crowdin Fix crowdin local patches application
gradle/wrapper Fix Gradle build
main Merge branch 'release'
mapsforge_patches fix #2171: MapsForge-related crash on Android 4.2
mapswithme-api fix ant project names
nine-old-androids disable lint check in nine-old-androids lib
play-services-base all libraries use API 22 for building
play-services-location all libraries use API 22 for building
showcaseview all libraries use API 22 for building
tests Fix tests
undobar all libraries use API 22 for building
.gitignore Ignore generated file
LICENSE Fixes #2946, Replace license file
NOTICE Fixes #2946, Replace license file Update
build.gradle Fix Gradle build
cgeo.iml Revert the url distinguistion from "Implement Android Beam (NFC Shari… Gradle files for android Studio 0.5.1+ (Gradle 0.9+)
gradlew Make gradlew executable
gradlew.bat Update original gradle support for current master
settings.gradle Add showcaseview to Gradle build

c:geo is an open source, full-featured, always ready-to-go client for (unofficial) and offers basic support for other geocaching platforms. It does not require a web browser or exports - just download and start right away.

You want to contribute?

Perfect! Please tell us in the issue tracker before hacking on your great new feature. It would be bad if you have implemented something great, but we can't include it because it doesn't fit the remaining architecture and code. You might also want to chat with the developers on channel #cgeo on the freenode IRC network.

Project status

Build Status
Issue Stats
Issue Stats
Dependency Status

Get the source

Fork the project source code, make changes to your clone and create a pull request afterwards.


  • master is for development of new features. Nightly builds are created from this branch.
  • release is for all bug fixes of already existing features. So if a bug is reported in released version, it should be fixed on this branch (and merged to master afterwards).

A more complex bugfix can be first tested against the master branch and integrated in the nightly builds, while kept compatible with the release branch for a later integration. Such a procedure is described in the wiki.

Set up Eclipse



  • Android SDK (latest version) including Google APIs V19
  • Ant 1.6.0+ for building c:geo on the command line (not necessary when using only Eclipse)
  • If you use Microsoft Windows, Google USB Driver to install the application on the smartphone


c:geo sources and executables are located in the main directory. Tests are located in the tests directory.

Known limitations

If the workspace directory name contains a space and leads to errors in the -dex Ant target, then you need to set the property "basedir" in your to the 8.3 name of the directory where this script is located on your disk.


  1. copy ./main/templates/ to ./main/
  2. edit (see comments in the file)
  3. copy ./main/templates/ to ./main/
  4. copy ./main/templates/ to ./tests/
  5. edit (see comments in the file)
  6. copy to all other projects (currently android-support-v7-appcompat, google-play-services_lib, mapswithme-api, showcaseview)
  7. copy to cgeo-calendar and cgeo-contacts if you plan to hack on the plugins
  8. copy ./main/templates/keys.xml to ./main/res/values/
  9. edit ./main/res/values/keys.xml and insert several keys (see comments in the file)

Building with Ant

Run one of the following commands in ./main

ant help
ant clean
ant debug
ant release

or use the Ant view of Eclipse


In Eclipse, create a Debug Configuration for an Android Application using the menu Run | Debug Configurations


The Test classes can be found in the project cgeo-os-test. Test classes should be located in the same package as the class under test. Every class can be "Run As" (or "Debug As") an Android JUnit Test from Eclipse. To run all tests use the same "Run As" menu item from the context menu of the test project.

For tests to run successfully you need to configure c:geo on the emulator that runs the test with a valid account. In order for all tests to be successfull the account needs to be premium.


c:geo is distributed under Apache License, Version 2.0.


Something went wrong with that request. Please try again.