Piepmatz is a Twitter client for Sailfish OS
Piepmatz is a Twitter client for Sailfish OS
Sebastian J. Wolf [email protected]
Licensed under GNU GPLv3
Some Sailfish OS devices feature a physical keyboard. Piepmatz is even easier to use with them using shortcuts:
Though Piepmatz is made to be as feature-rich as possible, some features such as the support for Twitter threads may only be available in the developer mode or be incomplete/failing from time to time. Reasons for that can be that the respective features are not available via official API, certain API features are not yet productively available (developer preview), they are rate limited or require a paid contract with Twitter. You can enable the developer mode on the settings page of Piepmatz. In addition, you need to set a valid Twitter API Bearer token there as well. Such a valid Twitter API Bearer token can be obtained by creating an account in the Twitter Developer Portal, registering a project and an application and by creating credentials for this application. Please see the Getting Started documentation for details.
Simply clone this repository, but be sure to clone it with --recursive
as Piepmatz uses Git Submodules.
Just use the project file harbour-piepmatz.pro
to import the sources in your SailfishOS IDE. To build and run Piepmatz or an application which is based on Piepmatz, you need to create the file harbour-piepmatz/src/o2/o1twitterglobals.h
(you can copy the sample from harbour-piepmatz/src/o2/o1twitterglobals.h.sample
) and enter the required constants in the following format:
#ifndef O1TWITTERGLOBALS_H
#define O1TWITTERGLOBALS_H
const char TWITTER_CLIENT_ID[] = "abcdef";
const char TWITTER_CLIENT_SECRET[] = "ghijkl";
const char TWITTER_STORE_DEFAULT_ENCRYPTION_KEY[] = "mnopqr";
#endif // O1TWITTERGLOBALS_H
You get the Twitter client ID and client secret as soon as you've registered your own application on dev.twitter.com. The default encryption key is only used in case Piepmatz is unable to determine a unique encryption key from the user's device. Under normal circumstances, Piepmatz uses an encryption key which was generated automatically. This key is used to encrypt the user's generated Twitter oAuth token (not the username/password!) on the user's device. Please use a password generator to generate the default key for your application.
Piepmatz also needs the package openssl-devel
to compile properly. You can install it on your build target using the Control Centre in your SailfishOS IDE.
This project uses
Piepmatz was translated to several languages. Thanks to all contributors!
Code improvements by: