{"id":21040980,"url":"https://github.com/chfoo/ttvsnap","last_synced_at":"2025-05-15T16:33:30.521Z","repository":{"id":145909891,"uuid":"48472154","full_name":"chfoo/ttvsnap","owner":"chfoo","description":"Save Twitch screenshots using Twitch API preview thumbnails","archived":false,"fork":false,"pushed_at":"2020-05-06T19:52:14.000Z","size":16,"stargazers_count":4,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-03T11:43:49.500Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chfoo.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":"2015-12-23T06:02:02.000Z","updated_at":"2020-05-25T17:14:42.000Z","dependencies_parsed_at":null,"dependency_job_id":"3c525ae1-dcd2-4c39-a127-43d973a54381","html_url":"https://github.com/chfoo/ttvsnap","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chfoo%2Fttvsnap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chfoo%2Fttvsnap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chfoo%2Fttvsnap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chfoo%2Fttvsnap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chfoo","download_url":"https://codeload.github.com/chfoo/ttvsnap/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254377495,"owners_count":22061155,"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":[],"created_at":"2024-11-19T13:49:31.863Z","updated_at":"2025-05-15T16:33:30.516Z","avatar_url":"https://github.com/chfoo.png","language":"Python","readme":"ttvsnap\n=======\n\nTtvsnap is script that will periodically save Twitch.tv screenshots using Twitch API preview thumbnails.\n\nUsage\n=====\n\nYou will need Python 3.3+.\n\nTo start the script, run something similar to this:\n\n        python3 ttvsnap.py verycoolstreamer ./screenshots/ --client-id YOUR_CLIENT_ID_HERE --client-secret-file FILENAME_TO_A_TEXT_FILE_WITH_CLIENT_SECRET --cache-dir PATH_TO_A_DIRECTORY_FOR_TEMP_SECRETS\n\n(Replace `python3` as needed, `python.exe` for example.)\n\nThe script will check every ~5 minutes and save the screenshot to the given directory. For streams that run 24/7, you can use the `--subdir` option to create a directory for each day.\n\nAs a convenience, it supports generating thumbnails using ImageMagick. Ensure that the `convert` command exists and add the `--thubmnail` option.\n\nFor the list of options, use the `--help` option.\n\nTips\n----\n\nIf you are using this script for a website of some sort, you may want to look into some daemon service management tools to restart it if it crashes. On Linux, look into creating Upstart or Systemd configuration files for it.\n\nAs of writing, Twitch caches preview images for 5 minutes so setting it to low values such as 1 minute may be useless. However, the script will use the `If-Modified-Since` HTTP header to avoid downloading images repeatedly.\n\nClient ID is required after 2016-08-08. You can get a Client ID in the Dev Console page by registering an application and using the Client ID for personal use. Client secret is required after 2020-04-30. Click generate new secret and keep the secret in a safe place.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchfoo%2Fttvsnap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchfoo%2Fttvsnap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchfoo%2Fttvsnap/lists"}