Skip to content

kush1jpeg/iStream

Repository files navigation

Logo
iStream

ArchitectureGetting StartedTilt SetupContributing


What is iStream?

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.

For contributors

wip

Open an issue here for suggestions, bugs, etc.

If you are contributing code, please read these docs first:

  • architecture —> to understand how the streaming pipeline, jobs, workers, and storage fit together.
  • contribute —> a humble request

Contact

Built by kush1jpeg


License

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.

About

iStream is a distributed twitch clone supporting adaptive bitrate streaming(abs) + segment level uploads to R2 + autoscaling worker pool + real-time chat over Socket.IO and rzp-gateway integration

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors