This repository hosts technical documentation and helpers for the SNH48 Live YouTube channel.
Check snh48live.org for more resources.
about.md
: general description of the channel.video-source.md
: technical info on how videos on the channel are extracted, and qualities thereof.config.md
: tool configurations documention.
videos.txt
: short list of all content videos (channel info videos are not included).data/videos/*.json
: metadata of content videos directly from YouTube API v3.partially-blocked.txt
: short list of videos that are blocked in some countries (seeclaims.md
for details). To get around region blocks, use a VPN service, e.g. Private Internet Access.claims.md
: list of videos and their associated copyright claims.claims.json
: list of videos and their associated copyright claims, in JSON format.performances.json
: a streamable line-oriented JSON data store of metadata of performances, used for snh48live.org/filter.attendance.txt
: human-readable attendance sheet (compiled by myself, might contain mistakes).attendance.json
: structured version ofattendance.txt
for machine consumption.
Helpers depend on Python 3.6+ and Zsh 5.0+.
download
: the heart and soul of this channel. Downloads a VOD from live.snh48.com, then optionally uploads it to the channel.extract-claims
: extract video info and associated copyright claims from a YouTube copyright claims page, and automatically populate related datastores.fetch-metadata
: fetch metadata of all content videos.fetch-schedule
: fetch and format schedule data from https://snh48live.org/schedule/; helper fornew-config
.new-config
: generate download/upload configuration for a new performance.new-attendance-entry
: automatically populate as much of a new attendance sheet entry as possible.parse-attendance-sheet
: convertattendance.txt
intoattendance.json
.performers
: retrieve performers lists from official streaming site.post-to-tumblr
: cross-post to Tumblr — a healthy dose of SEO and discoverability shenanigans doesn't hurt, right?qa
: basic quality assurance on Python source code.record-performance
: record performance metadata intoperformances.json
.searchrank
: find this channel and its videos among the top 50 SNH48-related search results. Purely for bragging rights.stats
: fetch and display channel analytics data.stats-monitor
: runstats
periodically, print and log results.tweet
: tweet to Twitter.thumbnail
: generate custom thumbnails.update-metadata
: update metadata of videos in various ways (check the subcommands).upload
: YouTube video uploader (WIP).