{"id":16446532,"url":"https://github.com/edoardottt/twitterbot2","last_synced_at":"2025-04-13T05:14:01.204Z","repository":{"id":38260948,"uuid":"390387664","full_name":"edoardottt/twitterbot2","owner":"edoardottt","description":"Like and retweet your tweets, or search tweets by topic. It stores and serves data with a Flask webapp. 🐦 Live demo running on twitter.com/ai_testing","archived":false,"fork":false,"pushed_at":"2024-11-10T09:21:49.000Z","size":758,"stargazers_count":60,"open_issues_count":4,"forks_count":8,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-13T05:13:56.675Z","etag":null,"topics":["automation","bot","bot-api","bot-application","bots","flask","flask-app","hacktoberfest","python","real-time","retweet","retweet-bot","tweet","tweet-analysis","tweets","twitter","twitter-api","twitter-bot","twitter-client","twitterbot"],"latest_commit_sha":null,"homepage":"https://edoardottt.com/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/edoardottt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"edoardottt","liberapay":"edoardottt","patreon":"edoardottt","ko_fi":"edoardottt","open_collective":"edoardottt","custom":"https://www.paypal.me/edoardottt"}},"created_at":"2021-07-28T14:47:44.000Z","updated_at":"2025-04-12T21:44:13.000Z","dependencies_parsed_at":"2023-11-29T10:47:09.453Z","dependency_job_id":"9118aa08-4b9a-4d62-9532-e6405095a796","html_url":"https://github.com/edoardottt/twitterbot2","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edoardottt%2Ftwitterbot2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edoardottt%2Ftwitterbot2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edoardottt%2Ftwitterbot2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edoardottt%2Ftwitterbot2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/edoardottt","download_url":"https://codeload.github.com/edoardottt/twitterbot2/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248665746,"owners_count":21142123,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","bot","bot-api","bot-application","bots","flask","flask-app","hacktoberfest","python","real-time","retweet","retweet-bot","tweet","tweet-analysis","tweets","twitter","twitter-api","twitter-bot","twitter-client","twitterbot"],"created_at":"2024-10-11T09:47:56.963Z","updated_at":"2025-04-13T05:14:01.175Z","avatar_url":"https://github.com/edoardottt.png","language":"Python","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/edoardottt/images/blob/main/twitterbot2/twitterbot2.png\"\u003e\u003cbr\u003e\n  \u003cb\u003eSimple bot for twitter.\u003c/b\u003e\u003cbr\u003e\n  \u003c!--badges--\u003e\n  \u003ca href=\"https://edoardottt.com\"\u003e\u003cimg src=\"https://github.com/edoardottt/images/blob/main/twitterbot2/python-version.svg\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://edoardottt.com\"\u003e\u003cimg src=\"https://github.com/edoardottt/images/blob/main/twitterbot2/linux-build-success-badge.svg\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://edoardottt.com\"\u003e\u003cimg src=\"https://github.com/edoardottt/images/blob/main/twitterbot2/win-build-success-badge.svg\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/edoardottt/twitterbot2/actions/workflows/python-app.yml\"\u003e\u003cimg src=\"https://github.com/edoardottt/twitterbot2/actions/workflows/python-app.yml/badge.svg\"/\u003e\u003c/a\u003e\n  \u003cbr\u003e\n  \u003csub\u003e\n    Coded with 💙 by edoardottt\n  \u003c/sub\u003e\n  \u003cbr\u003e\n  \u003c!--Tweet button--\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#description-\"\u003eDescription\u003c/a\u003e •\n  \u003ca href=\"#installation-\"\u003eInstall\u003c/a\u003e •\n  \u003ca href=\"#usage-\"\u003eUsage\u003c/a\u003e •\n  \u003ca href=\"#useful-noteslinks-\"\u003eNotes\u003c/a\u003e •\n  \u003ca href=\"#contributing-\"\u003eContributing\u003c/a\u003e •\n  \u003ca href=\"#license-\"\u003eLicense\u003c/a\u003e\n  \u003cbr\u003e\n  \u003cb\u003elive demo running on \u003ca href=\"https://twitter.com/ai_testing\"\u003e@ai_testing\u003c/a\u003e\u003c/b\u003e\n\u003c/p\u003e\n  \nDescription 🔦 \n--------\n\nSimple twitter bot that can like and retweet your tweets, or search tweets with a specified topic. It stores and serves data with a Flask webapp. 🐦\n\nInstallation 📡\n-------\n\n- `git clone https://github.com/edoardottt/twitterbot2`\n- `cd twitterbot2`\n- `pip install -r requirements.txt`\n- Edit the `config.yaml` and `globals.py` files \n- `python init_db.py`\n- `python twitterbot2.py -h`\n\nUsage 🚀\n-------\n\n```\nusage: twitterbot2.py [-h] [-v] [-t] [-k KEYWORD] [-p PORT] [-nu] [-nl] [-nr] [-s STATS] [-oc OUTPUT_CSV] [-oj OUTPUT_JSON] [-oh OUTPUT_HTML]\n\nTwitterbot v2\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -v, --version         Show the version of this program.\n  -t, --timeline        Search for tweets in the bot and user's timeline.\n  -k KEYWORD, --keyword KEYWORD\n                        Search for tweets with defined keyword(s). If more than one, comma separated enclosed in double quotes.\n  -p PORT, --port PORT  Set the port to be used (default 5555).\n  -nu, --no-user        Don't like and retweet user tweets.\n  -nl, --no-like        Don't like tweets, just retweet.\n  -nr, --no-retweet     Don't retweet tweets, just like.\n  -s STATS, --stats STATS\n                        Show the statistics of the inputted bot (username).\n  -oc OUTPUT_CSV, --output-csv OUTPUT_CSV\n                        Produce a csv file containing the stats for the inputted used (ALL for anyone).\n  -oj OUTPUT_JSON, --output-json OUTPUT_JSON\n                        Produce a json file containing the stats for the inputted used (ALL for anyone).\n  -oh OUTPUT_HTML, --output-html OUTPUT_HTML\n                        Produce a html file containing the stats for the inputted used (ALL for anyone).\n```\n\nSee [some examples](https://github.com/edoardottt/twitterbot2/wiki/Examples) to get started.\n\nUseful notes/links 🔗\n--------\n\n- [Getting access to the Twitter api](https://developer.twitter.com/en/docs/twitter-api/getting-started/getting-access-to-the-twitter-api)\n- [Twitter api rate limits](https://developer.twitter.com/en/docs/twitter-api/v1/rate-limits)\n- This app uses a Flask webserver (default port 5555). Expose it on public Internet at your own risk (I use it behind NAT/firewall).\n- [ValueError: Unrecognised argument(s): encoding](https://github.com/edoardottt/twitterbot2/issues/47)\n- [twitterbot2 Api documentation](https://github.com/edoardottt/twitterbot2/wiki/Api)\n\nChangelog 📌\n-------\nDetailed changes for each release are documented in the [release notes](https://github.com/edoardottt/twitterbot2/releases).\n\nContributing 🤝\n------\nIf you want to contribute to this project, you can start opening an [issue](https://github.com/edoardottt/twitterbot2/issues)/[pull request](https://github.com/edoardottt/twitterbot2/pulls).  \nRead also [Code of Conduct](https://github.com/edoardottt/twitterbot2/blob/main/CODE_OF_CONDUCT.md) and [Contributing](https://github.com/edoardottt/twitterbot2/blob/main/CONTRIBUTING.md) files.\n\nLicense 📝\n--------\n\nThis repository is under [GPLv3 License](https://github.com/edoardottt/twitterbot2/blob/main/LICENSE).  \n[edoardottt.com](https://edoardottt.com) to contact me.\n","funding_links":["https://github.com/sponsors/edoardottt","https://liberapay.com/edoardottt","https://patreon.com/edoardottt","https://ko-fi.com/edoardottt","https://opencollective.com/edoardottt","https://www.paypal.me/edoardottt"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedoardottt%2Ftwitterbot2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fedoardottt%2Ftwitterbot2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedoardottt%2Ftwitterbot2/lists"}