README
¶
Kinoview
Test coverage: 84.983% 😍👌
Host local movies within your private network with mandatory AI!
Installation
Option 1:
go install github.com/baalimago/kinoview@latest
Option 2:
curl -fsSL https://raw.githubusercontent.com/baalimago/kinoview/main/setup.sh | sh
How to use it?
kinoview s|serve -host 0.0.0.0 <directory-with-media>ip a- Browse to
<private-network-address>on your device - Enjoy media!
Butler Configuration
The butler prepares viewing suggestions on client disconnect. Three flags control cascade rate-limiting and caching:
# Minimum interval between butler suggestion cascades (default 30s, 0 disables)
kinoview serve -butlerDebounce 30s
# Grace period after pong timeout before triggering disconnect (default 10s, 0 disables)
kinoview serve -pongGrace 10s
# How long a cached suggestion set is served before re-querying (default 6h, 0 disables)
kinoview serve -butlerCacheTTL 6h
Concierge Configuration
The concierge manages suggestions periodically. Its schedule is configurable:
# Interval between concierge runs (default 6h, 0 runs once then stops)
kinoview serve -conciergeInterval 6h
The last-run timestamp is persisted to <cacheDir>/concierge_last_run, so
process restarts within the interval do not trigger additional runs.
LLM Usage Reporting
kinoview llm usage aggregates cost and token data from clai's persisted
conversation files. It parses the conversation directory, attributes each
file to an agent via its system prompt, and prints per-agent (or per-model,
per-day) totals.
# Default: per-agent aggregation over all time
kinoview llm usage
# Last 7 days, grouped by model
kinoview llm usage --since 168h --by model
# Machine-readable output
kinoview llm usage --json
See kinoview llm usage --help for all flags.
Why not Plex or Jellyfish?
I dunno. That's probably a better tool for the job. I don't have all the answers, man, I'm not omniscient or something?
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
debug
Debug command is intended to expose quick-acess to trigger agentic features in a controlled way.
|
Debug command is intended to expose quick-acess to trigger agentic features in a controlled way. |
|
llm
Package llm provides the `kinoview llm usage` subcommand for aggregating per-query cost and token data from clai's persisted conversation files.
|
Package llm provides the `kinoview llm usage` subcommand for aggregating per-query cost and token data from clai's persisted conversation files. |
|
media
Package media provides kinoview subcommands for interacting with the media store directly from the CLI without starting the full server stack.
|
Package media provides kinoview subcommands for interacting with the media store directly from the CLI without starting the full server stack. |
|
internal
|
|
|
agents/concierge
Package concierge is an agent which takes care of the media library and updates suggestsions it knows what you want before you do
|
Package concierge is an agent which takes care of the media library and updates suggestsions it knows what you want before you do |
|
agents/slivingdoc
Package slivingdoc builds the slivingdoc MCP callsign and the shared tool globs every agent uses to read and write the shared notebook, plus the shared worktree helper.
|
Package slivingdoc builds the slivingdoc MCP callsign and the shared tool globs every agent uses to read and write the shared notebook, plus the shared worktree helper. |
|
agents/theatre
Package theatre is the company that produces the intro splash story: a director superagent orchestrating mini-agent subagents.
|
Package theatre is the company that produces the intro splash story: a director superagent orchestrating mini-agent subagents. |
|
agents/theatre/tools
Package tools holds the theatre's mini-agent tools.
|
Package tools holds the theatre's mini-agent tools. |
|
s3embed
Package s3embed supervises a SeaweedFS child process that provides the S3-compatible backend for kinoview's shared agent notebook (slivingdoc).
|
Package s3embed supervises a SeaweedFS child process that provides the S3-compatible backend for kinoview's shared agent notebook (slivingdoc). |