Archive those tweets, and get a notification whenever one is deleted.
140 characters certainly has a lot to hide. If it's public, then why not archive it!
- Set up a new app on your Twitter account, and get all the necessary credentials ready (consumer key/secret, access token/secret). If you don't know what those are, then citizen140 is probably not for you.
- Clone C140 into a directory of your choice.
- Move into the directory that will serve as the root data directory for citizen140. This is where data will be stored, and it's best practice to keep this separated from C140's source. Source protection.
- Run main.py
- The program will close and tell you to edit the configuration file it just created. It'll tell you where to look.
- Edit the configuration file, adding the Twitter authentication credentials as needed.
- Add the twitter IDs of the users you want to monitor in the config file.
- Adjust the intervals as necessary. C140 operates under the idea of 'iterations': the program runs a loop, and every X loops (iterations), certain actions are conducted. Each iteration runs a 'quick' update, called a pass, in which new tweets are written to the database. The 'pass' field defines the amount of seconds between each pass. 'Account' defines how many passes between each account data update (account metadata, such as followers, following, bio, etc), and 'fullpass' defines how many passes between each scan, in which the latest 3400 (maximum permitted by Twitter API) tweets are loaded from Twitter, and deleted tweets are detected.
- Set something up in notificationhandler.py. Got something good? Submit a PR. An official notification system (via the email defined in configuration.json) will be implemented soon.
- Run main.py again
- Let C140 do its work!
This is a work in progress, and while it is stable and suitable for use, it should not be considered bulletproof (nor should any program for that matter).
Licensed under the MIT license.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.