harbour-fernschreiber/README.md

48 lines
2.8 KiB
Markdown
Raw Normal View History

2020-08-10 15:17:29 +03:00
# Fernschreiber
A Telegram client for Sailfish OS
## Author
Sebastian J. Wolf [sebastian@ygriega.de](mailto:sebastian@ygriega.de)
## Contributions
Fernschreiber wouldn't be the same without all the people helping in making it better. Thank you very much to all contributors!
### Code (Features, Bugfixes, Optimizations etc.)
- Chat list model, TDLib receiver, project dependencies: [Slava Monich](https://github.com/monich)
- Location support, app initialization/registration with Telegram, project dependencies: [jgibbon](https://github.com/jgibbon)
### Translations
- Chinese: [dashinfantry](https://github.com/dashinfantry)
- Hungarian [edp17](https://github.com/edp17)
- Polish: [atlochowski](https://github.com/atlochowski)
- Spanish: [GNUuser](https://github.com/GNUuser)
2020-08-10 15:17:29 +03:00
## License
Licensed under GNU GPLv3
## Build
Simply clone this repository and use the project file `harbour-fernschreiber.pro` to import the sources in your SailfishOS IDE. To build and run Fernschreiber or an application which is based on Fernschreiber, you need to create the file `harbour-fernschreiber/src/tdlibsecrets.h` and enter the required constants in the following format:
```
#ifndef TDLIBSECRETS_H
#define TDLIBSECRETS_H
const char TDLIB_API_ID[] = "42424242";
const char TDLIB_API_HASH[] = "1234567890abcdef1234567890abcdef";
#endif // TDLIBSECRETS_H
```
You get the Telegram API ID and hash as soon as you've registered your own application on [https://my.telegram.org](https://my.telegram.org).
Moreover, you need to have a compiled version of [TDLib](https://github.com/tdlib/td) in the sub-directory `tdlib`. This sub-directory must contain another sub-directory that fits to the target device architecture (e.g. armv7hl, i486). Within this directory, there needs to be a folder called `lib` that contains at least `libtdjson.so`. For armv7hl the relative path would consequently be `tdlib/armv7hl/lib`.
2020-10-04 14:36:30 +03:00
If you want to contribute bug fixes, improvements, new features etc. please create a pull request (PR). PRs are always welcome and will be reviewed as soon as possible, but may take some time. :)
2020-08-10 15:17:29 +03:00
## Credits
This project uses
- The Telegram Database Library (TDLib) - available on [GitHub.com](https://github.com/tdlib/td). Thanks for making it available under the conditions of the Boost Software License 1.0! Details about the license of TDLib in [its license file](https://github.com/tdlib/td/blob/master/LICENSE_1_0.txt).
2020-08-13 23:42:54 +03:00
- Emoji parsing and artwork by [Twitter Emoji (Twemoji)](http://twitter.github.io/twemoji/), copyright 2018 Twitter, Inc and other contributors, Code licensed under the [MIT License](http://opensource.org/licenses/MIT), Graphics licensed under [CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/)
2020-09-22 21:43:36 +03:00
2020-09-22 21:44:53 +03:00
Fernschreiber was translated to several languages. Thanks to all contributors!