76fca004ee | ||
---|---|---|
app | ||
assets | ||
gradle/wrapper | ||
.gitignore | ||
CONTRIBUTING.md | ||
LICENSE.txt | ||
README.md | ||
build.gradle | ||
gradle.properties | ||
gradlew | ||
gradlew.bat | ||
settings.gradle |
README.md
Tusky
Tusky is a beautiful Android client for Mastodon. Mastodon is a GNU social-compatible federated social network. That means not one entity controls the whole network, rather, like e-mail, volunteers and organisations operate their own independent servers, users from which can all interact with each other seamlessly.
Features
- Material Design
- Most Mastodon APIs implemented
- Push notifications
Head of development
My Mastodon account is Vavassor@mastodon.social.
Building
The most basic things needed are the Java Development Kit 7 or higher and the Android SDK.
The project uses the Gradle build system. Android studio uses Gradle by default, so it'd be straightforward to import this repository using your chosen version control software from the menu:
VCS > Checkout from version control > Git/SVN/Mercurial
After making it into an android studio project you can build/run as you wish.
It's also possible to build using Gradle by itself on the command line if you have it installed and configured. This repository includes a gradle wrapper script that can be used, following this guide Build You App On The Command Line.
The project's gradle files describe its building needs more in-depth and dependencies can be found in app/build.gradle
.
Firebase
This app uses Firebase's Cloud Messaging and Crash Reporting. So, in order to build with your own Firebase project, associate it with the build by replacing google-services.json
file in the app
directory with one from your Firebase console.
Tusky-API
Tusky uses its own server for push notifications, the tusky-api server. This system works with Firebase and the Tusky-API server in tandem. After that is set up as per its directions, the only thing needed to call the server in this project is to give its URL to the string tusky_web_url
in the file app/src/main/res/values/donottranslate.xml
.