{"id":19399377,"url":"https://github.com/lawolf8/sludge-content-automation","last_synced_at":"2026-05-12T23:03:43.201Z","repository":{"id":254859361,"uuid":"837461751","full_name":"lawolf8/sludge-content-automation","owner":"lawolf8","description":"Social media is now overwhelmingly popular, most humans spend hours a day on various platforms. This repo provides a large techstack to profit off social media, providing content creating, content posting, analytics, and optimization.","archived":false,"fork":false,"pushed_at":"2024-08-29T21:29:17.000Z","size":49,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-24T23:28:48.192Z","etag":null,"topics":["analytics-tracking","api","database-management","gui","hastags","machine-learning","python","sludge","socialmediaanalytics","ssms","tiktok","tkinter","virustotal","virustotal-api","youtube","youtube-api"],"latest_commit_sha":null,"homepage":"","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/lawolf8.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"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}},"created_at":"2024-08-03T03:59:13.000Z","updated_at":"2024-08-29T21:29:20.000Z","dependencies_parsed_at":"2024-08-29T22:18:48.608Z","dependency_job_id":null,"html_url":"https://github.com/lawolf8/sludge-content-automation","commit_stats":null,"previous_names":["lawolf8/sludge-content-automation"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/lawolf8/sludge-content-automation","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lawolf8%2Fsludge-content-automation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lawolf8%2Fsludge-content-automation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lawolf8%2Fsludge-content-automation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lawolf8%2Fsludge-content-automation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lawolf8","download_url":"https://codeload.github.com/lawolf8/sludge-content-automation/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lawolf8%2Fsludge-content-automation/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":284971136,"owners_count":27093121,"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","status":"online","status_checked_at":"2025-11-17T02:00:06.431Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["analytics-tracking","api","database-management","gui","hastags","machine-learning","python","sludge","socialmediaanalytics","ssms","tiktok","tkinter","virustotal","virustotal-api","youtube","youtube-api"],"created_at":"2024-11-10T11:09:07.070Z","updated_at":"2025-11-17T23:03:44.013Z","avatar_url":"https://github.com/lawolf8.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![made-with-python](https://img.shields.io/badge/Made%20with-Python3-brightgreen) \n![made-with-sql](https://img.shields.io/badge/Made%20with-sql-blue)\n\n\u003c!-- LOGO --\u003e \u003cbr /\u003e \u003cp align=\"center\"\u003e \u003cimg src=\"https://user-images.githubusercontent.com/54740007/212677385-8f453f16-06fd-41e2-83a6-8a25d5435418.png\" alt=\"TikTok Logo\" width=\"80\" height=\"80\"\u003e \u003cimg src=\"https://upload.wikimedia.org/wikipedia/commons/4/42/YouTube_icon_%282013-2017%29.png\" alt=\"YouTube Logo\" width=\"80\" height=\"80\"\u003e \u003ch3 align=\"center\"\u003eSludge-Content-Automation\u003c/h3\u003e \u003cp align=\"center\"\u003e\n\n\n## About The Project\nWORK IN PROCESS | ESTIMATED COMPLETION DATE: 09/08/2024\nThis project is made with Python 3 and is comprised of 5 aspects.\n\n1. Youtube: This will utilize google APIs, VirusTotal API, and some OS libraries (such as moviepy) to download youtube videos, store metrics, check the downloaded file for viruses, stack videos, and log the videos metrics from Youtube.\n2. TikTok: Utilizing the TikTok Desktop App, can upload (and schedule upload) and log metrics from TikTok videos using OS libraries (since you cannot use TikTok's APIs unless you have an app)\n3. Database: With the metrics gathered from Youtube and Tiktok, this will all be stored in a database within various tables to be used to determine the best content (which videos get the most views, what hastags have the most traction, etc.\n4. Machine Learning: Uses the data collected from views of videos to determine rising hashtag popularity, optimal content, and more to maximize views per post.\n5. GUI: User Interface as a dashboard to view metrics, data analytics, and encourage decision making on their social media platforms\n\n## Getting Started\nTo get started you need to have python3 installed. If it is not the case you can download it here : https://www.python.org/downloads/\u003cbr\u003e\u003cbr\u003e\n\n\n### Installation\nMake sure you've already git installed. Then you can run the following commands to get the scripts on your computer:\n   ```sh\n   git clone https://github.com/lawolf8/sludge-content-automation\n   cd sludge-content-automation\n   ```\nThe script only requires the `requests` module, you can install it with this command:\n```sh\npip install -r requirements.txt\n```\n   \n## Usage\n### Import in your script\nYou can copy the file `Tiktok_uploader.py` in your project folder and use it like this:\n```python\nfrom Tiktok_uploader import uploadVideo\n\nsession_id = \"7a9f3c5d8f6e4b2a1c9d8e7f6a5b4c3d\"\nfile = \"my_video.mp4\"\ntitle = \"MY SUPER TITLE\"\ntags = [\"Funny\", \"Joke\", \"fyp\"]\nschedule_time = 1672592400\n\n# Publish the video\nuploadVideo(session_id, file, title, tags, verbose=True)\n# Schedule the video\nuploadVideo(session_id, file, title, tags, schedule_time, verbose=True)\n```\n- `session_id`: Your TikTok *sessionid* cookie.\u003cbr\u003e\n- `file`: The path to the video you want to upload.\u003cbr\u003e\n- `title`: The title of your publication (without hashtags).\u003cbr\u003e\n- `tags`: The list of hashtags you want to add to your post (without `#` symbol). May be empty list `[]`.\u003cbr\u003e\n- `schedule_time`: The timestamp (in seconds) at which you want to schedule your video.\u003cbr\u003e\n**Note that you cannot schedule a video more than 10 days in advance.**\u003cbr\u003e\n**Note that your TikTok *sessionid* cookie needs to be updated every 2 months.**\n\n### With the command line\n```\nusage: Tiktok_uploader.py [-h] -i SESSION_ID -p PATH -t TITLE [--tags [TAGS ...]] [-s SCHEDULE_TIME]\n\noptions:\n  -h, --help            show this help message and exit\n  -i SESSION_ID, --session_id SESSION_ID\n                        Tiktok sessionid cookie\n  -p PATH, --path PATH  Path to video file\n  -t TITLE, --title TITLE\n                        Title of the video\n  --tags [TAGS ...]     List of hashtags for the video\n  -s SCHEDULE_TIME, --schedule_time SCHEDULE_TIME\n                        schedule timestamp for video upload\n```                        \nThe `session_id`, `path` and `title` fields are required.\n    \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flawolf8%2Fsludge-content-automation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flawolf8%2Fsludge-content-automation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flawolf8%2Fsludge-content-automation/lists"}