Architecture • Getting Started • Tilt Setup • Contributing
iStream rebuilds a production-grade live-streaming stack from primitives, no managed streaming services anywhere in the pipeline.
RTMP ingest → adaptive-bitrate FFmpeg streaming → HLS delivery for live, segment-level transcoded uploads to Cloudflare R2 for VOD. The whole pipeline runs behind a Dockerode-managed worker pool that autoscales transcoding capacity up and down with live load, coordinated through redis-backed lease state so dead/abandoned streams get reclaimed without manual intervention.
Beyond media: real-time chat over namespaced Socket.IO (sidebar, notify, dm, group, live), a razorpay integration for superchats, an isolated notification service with per-user pub/sub fan-out, and a reconciliation worker that cleans up expired payments.
Open an issue here for suggestions, bugs, or feature requests.
Interested in contributing? Read these first:
- Architecture — understand how the streaming pipeline, jobs, workers, and storage fit together.
- Contributing — contribution guidelines and project setup.
Built by kush1jpeg
- GitHub: @kush1jpeg
- LinkedIn: kushagra-gupta-dystopia
- Portfolio: kush1jpeg.github.io
- Email: kushuvikas@gmail.com
iStream is licensed under the BSD 3-Clause License.
Copyright (c) 2025, Kushagra Gupta(@owner). All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following described conditions are met.