1# Cheogram Android
 2
 3This is a fork of [Conversations](https://conversations.im) to implement features of use to the [Sopranica](https://soprani.ca) project.
 4
 5The Cheogram Android app allows you to join a worldwide communication network.  It especially focuses on features useful to users who want to contact those on other networks as well, such as SMS-enabled phone numbers.
 6
 7Based on the app Conversations, but with unique features:
 8
 9* Messages with both media and text, including animated media
10* Unobtrusive display of subject lines, where present
11* Links to known contacts are shown with their name
12* Show timestamps for calls
13* Integrates with gateways' add contact flows
14* When using a gateway to the phone network, integrate with the native Android Phone app
15* Address book integration
16* Tag contacts and channels and browse by tag
17* Command UI
18
19## Getting Help
20
21If you have any questions about this app, or wish to report a bug, please send email to dev@singpolyma.net or join us in [xmpp:discuss@conference.soprani.ca?join](xmpp:discuss@conference.soprani.ca?join)
22
23## Contributing
24
25If you have code or patches you wish to contribute, the maintainer's preferred mechanism is a git pull request.  Push your changes to a git repository somewhere, for example:
26
27    git remote rename origin upstream
28    git remote add origin git@git.sr.ht:~yourname/cheogram-android
29    git push -u origin master
30
31Then generate the pull request:
32
33    git fetch upstream master
34    git request-pull -p upstream/master origin
35
36And copy-paste the result into a plain-text email to: dev@singpolyma.net
37
38You may alternately use a patch-based approach as described on https://git-send-email.io
39
40Contributions follow an inbound=outbound model -- you (or your employer) keep all copyright on your patches, but agree to license them according to this project's COPYING file.