Skip to content
An Android app that lets you use your access control card cloning devices in the field.
Java HTML
Branch: master
Clone or download

Latest commit

dunderhay Update README
Add hardware sponsor and remove FAQ related to release issue
Latest commit 5b84e32 Jun 17, 2019

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.idea Remove buildToolsVersion Mar 10, 2019
app Add Chameleon Mini Rev.E Rebooted supported Apr 7, 2019
gradle/wrapper Update Gradle Mar 10, 2019
.gitignore Add viewing and editing of card data Apr 24, 2018
LICENSE Create LICENSE Feb 17, 2018
README.md Update README Jun 17, 2019
build.gradle Update Gradle Mar 10, 2019
gradle.properties Refresh Google Maps API key Mar 7, 2018
gradlew Initial commit from Android Studio Apr 29, 2017
gradlew.bat Initial commit from Android Studio Apr 29, 2017
settings.gradle Add GPLv3 copyright and license notices to each file Mar 6, 2018
test-checklist.txt Create test checklist Mar 7, 2018

README.md

Walrus

Build Status GitHub release GPLv3 license Slack invite

Intro

Walrus is an Android app for contactless card cloning devices such as the Proxmark3 and Chameleon Mini. Using a simple interface in the style of Google Pay, access control cards can be read into a wallet to be written or emulated later.

Designed for physical security assessors during red team engagements, Walrus supports basic tasks such as card reading, writing and emulation, as well as device-specific functionality such as antenna tuning and device configuration. More advanced functionality such as location tagging makes handling multiple targets easy, while bulk reading allows the stealthy capture of multiple cards while “war-walking” a target.

Installing

Get it on Google Play

Documentation

Documentation and Getting Started. For end-user information such as what Walrus is, and how it can be used in the field, check out the Walrus website!

Development

Walrus is developed by Daniel Underhay and Matthew Daley (a.k.a. Team Walrus!) and is Open Source

Building

Walrus is a standard Android Studio project. At this stage there are no unusual dependencies or build steps beyond the usual cloning of the repository and opening the project in Android Studio.

TODO: When we refresh and remove the current Google Maps API key from the repo, we'll need to point out that this needs to be generated and set manually if maps are needed.

Codebase

The current layout of Walrus's source code is as follows:

  • /app/src/main

    • /assets: Any non-resource assets, like the open source license listing.

    • /res: Resource files.

    • /java/com/bugfuzz/android/projectwalrus: Actual code lives here!

      • /card: Code to do with persistent data (i.e. the wallet). The Card class, the base CardData class and various card data type classes, database models and database helpers are here.

      • /device: Device-agnostic and device-specific driver code. The important CardDeviceManager lives here alongside the base CardDevice class and its child classes for various basic kinds of device (serial, line-based, etc.). Code to handle bulk reading is also located here.

        • /proxmark3: Proxmark3 driver code.

        • /chameleonmini: Surprise! Chameleon Mini driver code.

      • /ui: Code to do with other UI.

      • /util: Miscellaneous.

Hardware

Team Walrus is powered by Lab401, our official hardware sponsor 🥳 Check out their website for some great deals on hardware!

Device Support

Here’s a table of the current devices / card type pairs we support and in what manner.

Key: R = reading, W = writing, U = upload

Proxmark3 Original Pm3 Evo Pm3 RDV4 Pm3 Iceman Fork Chameleon Mini Rev.G C.M Rev.E Rebooted
HID Prox R / W R / W R / W R / W - -
ISO14443A - UID - - - - R / U U
Mifare Ultralight - - - - - -
Mifare Classic 1K R / W R / W R / W R / W U U
Mifare Classic 4K ? ? ? ? ? ?
Mifare Classic 4B ? ? ? ? ? ?
Mifare Classic 7B ? ? ? ? ? ?
Mifare DESFire ? ? ? ? ? ?

Contributing

We welcome all kinds of contributions and bug reports, big or small! Development takes place at our GitHub repository. There you can file issues (both bugs and enhancement requests) and submit pull requests. Feel free to join our Slack channel.

During the initial development of Walrus, changes to the codebase are likely to be frequent and wide-ranging, so if you want to work on a feature, it's wise to reach out first to ensure that your hard work won't be soon obsoleted. After our first full release we hope to gain stability and bring in some of the additional resources expected of a project today, such as a proper test suite and continuous integration.

One area we'd love your help with is contributing translations! If you think you can help us out translating our Android string resources to another language, please get in touch!

You can’t perform that action at this time.