The Serval Mesh app for Android. EXPERIMENTAL SOFTWARE.
C Java C++ Roff Assembly HTML Other
Latest commit 8ed390e May 23, 2017 @lakeman lakeman Sync serval-dna
Permalink
Failed to load latest commit information.
.idea Add android studio project files Apr 18, 2017
app Sync serval-dna May 23, 2017
art Remove all references to batman and olsr May 23, 2012
doc Revise developer documentation Apr 18, 2017
google_play Update play store text May 16, 2016
gradle/wrapper Add gradle build Apr 18, 2017
.gitignore Move sources around to match typical gradle build process, remove obs… Apr 11, 2017
.gitmodules Move sources around to match typical gradle build process, remove obs… Apr 11, 2017
CC-BY-4.0.md Add text of CC BY 4.0 license May 21, 2014
COPYING First cut of UI changes Aug 8, 2011
CREDITS.md Final documentation updates May 16, 2016
CURRENT-RELEASE.md Start release notes for 0.94 Sep 12, 2016
DEVELOP.md Revise developer documentation Apr 18, 2017
INSTALL.md Revise developer documentation Apr 18, 2017
LICENSE-DOCUMENTATION.md Add text of CC BY 4.0 license May 21, 2014
LICENSE-SOFTWARE.md Add text of CC BY 4.0 license May 21, 2014
PRIVACY.md Add text of CC BY 4.0 license May 21, 2014
README.md Add DEVELOP.md with instructions for developers May 3, 2015
aa Start work on filtering logcat output to focus on recognised serval p… Apr 3, 2014
batphone.iml Add android studio project files Apr 18, 2017
build.gradle Add gradle build Apr 18, 2017
cc-by-4.0.png Documentation license CC BY 4.0 International May 20, 2014
gradle.properties Add gradle build Apr 18, 2017
gradlew Add gradle build Apr 18, 2017
gradlew.bat Add gradle build Apr 18, 2017
settings.gradle Add gradle build Apr 18, 2017

README.md

Serval Mesh README

Serval Project, March 2014

Serval Mesh (also called “Batphone”) is an app for Android 2.2 “Froyo” and above. It provides free, secure phone-to-phone voice calling, SMS and file sharing over Wi-Fi, without the need for a SIM card or a commercial mobile telephone carrier. In other words, it lets your Android phone communicate with other Android phones running Serval Mesh within Wi-Fi range.

The latest release of Serval Mesh is available for download on Google Play.

Serval Mesh is free software produced by the Serval Project. The Java/XML source code of Serval Mesh is licensed to the public under the GNU General Public License version 3. The serval-dna component of Serval Mesh is licensed to the public under the GNU General Public License version 2. All technical documentation is licensed to the public under the Creative Commons Attribution 4.0 International license.

All source code and technical documentation is freely available from the Serval Project's batphone and serval-dna Git repositories on GitHub.

Warnings

Serval Mesh is EXPERIMENTAL SOFTWARE. It has not yet reached version 1.0, and is intended for pre-production, demonstration purposes only. It may not work as advertised, it may lose or alter messages and files that it carries, it may consume a lot of space, speed and battery, and it may crash unexpectedly.

The Serval Mesh "Connect" screen allows you to connect to other Serval Mesh devices that provide their own access points. If you do so, this will cut off normal Wi-Fi network access while Serval Mesh is running, and services like Google Updates, E-mail, social media and other notifications may not work, or if you have a mobile data plan, may cost you money.

On the Serval Mesh "Connect" screen, connecting to any network marked "HotSpot" will put your device's Wi-Fi into Access Point mode. This will give nearby devices access to your mobile data plan, and COULD COST YOU MONEY.

On the Serval Mesh "Connect" screen, connecting to any network marked "Mesh" will request root permission (super-user) on your Android device in order to put Wi-Fi into [Ad-Hoc mode][]. If you grant super-user permission to Serval Mesh, this will cut off normal Wi-Fi network access while Serval Mesh is running, and services like Google Updates, E-mail, social media and other notifications may not work, or if you have a mobile data plan, may cost you money.

Serval Mesh telephony is a “best effort” service, primarily intended for when conventional telephony is not possible or cost effective, and MUST NOT BE RELIED UPON for emergencies in place of carrier-grade communications systems. The Serval Project cannot be held responsible for any performance or non-performance of the technologies that they provide in good will, and if you use these technologies you must agree to indemnify the Serval Project from any such claims.

The Serval Mesh software copies all files shared using the Rhizome file distribution service to other phones and devices running the Serval Mesh software, regardless of size, content or intended recipient. The Serval Project cannot be held responsible for the legality or propriety of any files received via Rhizome, nor for any loss, damage or offence caused by the transmission or receipt of any content via Rhizome.

Documentation

  • CURRENT-RELEASE.md Release notes for the current release.

  • INSTALL.md Instructions for building the Android APK from the source code and installing manually.

  • DEVELOP.md Tips for contributing to the software

  • PRIVACY.md Privacy policy.

  • doc Technical documentation, including past release notes.

  • CREDITS.md Individuals and organisations who have contributed to the software.

  • Serval Wiki contains helpful information for developers and users.

  • GitHub Issues Tracking of bug reports and tasks. Please see the wiki pages on reporting bugs and managing issues before adding any new issues.


Copyright 2014 Serval Project Inc.
CC-BY-4.0 This document is available under the Creative Commons Attribution 4.0 International licence.