npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

stream-clip-maker

v0.1.0

Published

Find stream highlights and create vertical clips with an easy desktop app.

Readme


The best moments are already in the chat.

A sudden flood of emotes. Everyone typing at once. A reaction spike you don't want to miss.

Stream Clip Maker analyzes chat activity, finds standout moments, and helps turn them into shareable clips — without manually scrubbing through an entire VOD.

Why Stream Clip Maker?

| Feature | What it does | | --- | --- | | Chat-powered discovery | Finds reaction spikes using unique chatters and reaction signals. | | Twitch + YouTube chat | Supports TwitchDownloader chat JSON and YouTube live-chat replay JSONL. | | Highlight ranking | Scores and merges nearby peaks into reviewable clip candidates. | | Vertical video | Creates 9:16 clips with a blurred background. | | Local-first workflow | Runs on your machine; no hosted processing service required. | | Creator review | Keeps the workflow review-first instead of automatically publishing content. |

How it works

  1. Get the chat replay from a Twitch VOD or YouTube livestream.
  2. Analyze reactions to find windows with unusually high viewer activity.
  3. Review candidates and choose the moments worth clipping.
  4. Render vertical clips with FFmpeg.
  5. Review and share only content you have permission to reuse.

Desktop downloads — v0.1.0

Official desktop installers for Linux x64 and Windows x64. Each link downloads directly from the public GitHub release.

| Platform | Package | Direct download | | --- | --- | --- | | Linux Debian / Ubuntu | DEB | Download DEB | | Linux Fedora | RPM | Download RPM | | Linux portable | AppImage | Download AppImage | | Windows | MSI | Download MSI | | Windows | EXE | Download EXE |

Linux: install DEB/RPM with your package manager. For AppImage, run chmod +x on the downloaded file and launch it. Windows: run the MSI or EXE installer.

macOS: this release has no supported native desktop installer. Use the guided TUI from a source checkout:

git clone https://github.com/kathennn/stream-clip-maker.git
cd stream-clip-maker
npm install
node cli.mjs

Install Node.js 18+, FFmpeg and the download tools needed by your workflow. The menu includes Search, Create, Enhance, Share, Setup & Help and Check. Rendering and publishing require confirmation; nothing is auto-published.

The desktop app processes files locally. Install FFmpeg and whichever of yt-dlp / TwitchDownloaderCLI your workflow needs. See the official download website.

Interactive terminal interface

Run Stream Clip Maker without arguments to open the guided TUI:

stream-clip-maker

Choose an action from the menu and follow the prompts to analyze a chat, create clips from a Twitch VOD / supported URL / local video, discover Twitch streams, or add subtitles and a title to a vertical clip. The interface asks for confirmation before starting video rendering. It never publishes videos automatically.

Advanced users can keep using the original flags and scripts; for example, stream-clip-maker chat.json --vertical --top 5.

Quick start

1. Install

Requires Node.js 18+.

npm install --global stream-clip-maker

Or run it without a global install:

npx stream-clip-maker

2. Download a chat replay

Twitch

TwitchDownloaderCLI chatdownload --id <VOD_ID> -o chat.json

YouTube live chat replay

yt-dlp --skip-download --write-subs --sub-langs live_chat -o stream "<YOUTUBE_URL>"

3. Find highlight moments

Twitch VOD

stream-clip-maker chat.json --vod <VOD_ID> --vertical

YouTube replay

stream-clip-maker stream.live_chat.json --url "<YOUTUBE_URL>" --vertical

4. Render your clips

Add --run to execute the generated FFmpeg commands:

stream-clip-maker chat.json --vod <VOD_ID> --vertical --run --out clips

You can also render from a local video:

stream-clip-maker chat.json --video recording.mp4 --vertical --run --out clips

Open the guided interface with stream-clip-maker, or see advanced options with:

stream-clip-maker --help

How it works

  • Chat is grouped into 10-second windows.
  • Each window is scored using unique chatters and the share of those chatters posting reaction messages.
  • Windows dominated by repeated, poll-like messages are down-weighted.
  • Candidate moments must exceed a rolling baseline and minimum-reactor thresholds.
  • Nearby peaks are merged into a clip, up to the configured maximum duration.
  • The first three minutes are skipped by default to reduce greeting-related spikes.

The detector is heuristic, not an AI model. Chat reactions may refer to what the streamer says or does, not only the game. Always review the selected moments and rendered clips.

Vertical video

The --vertical option creates a 9:16 version with a blurred background. Automatic face tracking and smart subject reframing are not currently included.

Requirements

| Tool | Needed for | | --- | --- | | Node.js 18+ | Running the CLI | | FFmpeg | Cutting and rendering video | | TwitchDownloaderCLI | Downloading Twitch VOD chat / media | | yt-dlp | Downloading YouTube media and chat replay | | Whisper.cpp (optional) | Speech transcription for the Termux subtitle workflow |

The core chat-analysis command has no third-party Node.js runtime dependencies. Downloading and rendering media requires the relevant external tools.

Android / Termux extras

The repository also includes optional scripts for the project's Android workflow:

| Script | Purpose | | --- | --- | | discover-twitch.sh | Search live Twitch channels and archived VODs by category using Twitch Helix. | | make-clips.sh | Download Twitch chat, detect moments, render vertical clips, add Spanish captions/title, and copy outputs to Downloads. | | enhance-clip.sh | Transcribe Spanish speech with Whisper.cpp and burn in title/subtitles. | | youtube-auth.mjs | Configure local YouTube OAuth. | | youtube-upload.mjs | Validate and upload a final Short as private. | | publish-short.sh | Wrapper for the review-first YouTube upload flow. |

These helpers require additional local tools and configuration. They are not a hosted service and do not publish automatically.

Twitch discovery setup

  1. Create an application in the Twitch Developer Console.
  2. Copy .env.example to .env.
  3. Set TWITCH_CLIENT_ID and TWITCH_CLIENT_SECRET in .env.
  4. Add creator logins you have permission to edit to allowedCreators in rules.json.
  5. Run the discovery script from your repository checkout:
./discover-twitch.sh "GTA 6"

Discovery is not permission. Finding a channel through Twitch's API does not grant rights to reuse its content. Only creators explicitly listed in allowedCreators should be treated as authorized by your local workflow.

YouTube upload safety

The upload helper:

  • Requires the explicit --confirm-rights flag.
  • Accepts only files ending in _final.mp4.
  • Checks for 1080×1920 resolution and a duration of up to 180 seconds.
  • Uploads as private for manual review.

Review the clip, creator permissions, title, and description before publishing.

ChatGPT plugins

The repository includes two ready-to-import, skills-only plugin packages:

To use one with ChatGPT, download its ZIP and add it through Plugin Creator / the plugin import flow available in your ChatGPT account. Once saved, select the plugin in a conversation and describe the task.

Important: these are instruction/skill plugins, not remote execution servers. The Remote Desktop Commander Guide does not grant computer access. Connect the official Remote Desktop Commander integration separately, authorize your device, and then use the guide alongside it. See the plugin folders for full instructions.

Development

Clone the repository:

git clone https://github.com/kathennn/stream-clip-maker.git
cd stream-clip-maker
npm test
npm pack --dry-run

Contributing

Bug reports, feature requests, and pull requests are welcome. Please include reproduction steps and relevant environment details, but never attach API keys, OAuth credentials, private chat logs, or copyrighted media you do not have permission to share.

License

Released under the MIT License.