Skip to content
KSIUJPublic

About

Stream without cables or video calls

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

KStreamI

Wireless screen-casting to classroom projectors over the faculty network. Cast your screen to the projector without leaving your seat - no cables, no adapter roulette. Think Chromecast, but built to work on the faculty network.

KSInternships project, [2026]. MVP.

The problem

Presenting from your laptop in class usually means a scramble for the right adapter or the one cable that works. Off-the-shelf casting (Chromecast, etc.) doesn't play nicely with the faculty network. KStreamI solves this: a client on student laptops, a server on the room computer, and a simple way to manage who's sharing.

How it works

TBD

MVP scope

TBD

Tech stack

Tech stack

Getting started

Prerequisites

  • Docker
  • Docker Compose plugin

Run

From the project root, run:

docker compose up --build

Then open:

Screen capture requires HTTPS or localhost

To stop the application, press Ctrl+C.

To stop and remove the containers, run:

docker compose down

Secure LAN run

To test screen capture and signaling from another device on the same network, copy the example environment file and set KSTREAMI_HOST to the server's LAN IP address:

cp .env.example .env

For example:

KSTREAMI_HOST=192.168.1.100

Then start the application behind the Caddy HTTPS/WSS gateway:

docker compose -f compose.wss.yaml up --build

The application and health check are available at:

  • Application: https://<KSTREAMI_HOST>:8080
  • API health check: https://<KSTREAMI_HOST>:8080/api/health

Caddy uses its internal certificate authority for LAN addresses. A browser that does not trust this authority will display a certificate warning on the first visit. For controlled development testing, accept the warning or install Caddy's root certificate on the test device.

To stop and remove the secure deployment, run:

docker compose -f compose.wss.yaml down

Tests

Backend

Run the backend tests from the project root:

python -m pip install -r backend/requirements-dev.txt
(cd backend && python -m pytest -v)

Frontend

This project uses Vitest and React Testing Library. To run tests in /frontend:

  1. npm install
  2. npm run test

Project structure

TBD

Team

👩🏼‍💻Maria Bagińska
👩🏼‍💻Zofia Bolesławska
👨🏻‍💻Jakub Karczyński
👩🏼‍💻Urszula Pilśniak

Mentor
👩🏼‍💻Kinga Żmuda

About

Stream without cables or video calls

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages