Turn media into evidence your agent can cite.

Voidscape reads video, audio, images, articles, and feeds through one visible sequence: inspect, preview, read.

local-firstaudio stays yours by default
cost-awarepreview before processing
agent-nativeframes + citations, not guesswork
// How it works

Inspect. Preview. Read.

One visible sequence turns an opaque source into evidence an agent can verify.

  1. 01Inspect

    See what the source contains.

  2. 02Preview

    Check cost, dependencies, and consent.

  3. 03Read

    Create local artifacts with citations. Read one source or a manually reviewed batch. Keep word timing, original transcripts, and clearly labeled complete, stopped, or partial evidence.

See the complete five-command guide

See the cost before you press play.

Preview is a decision point, not a receipt. It exposes the frame plan, transcription path, cloud boundary, and model-download state before reading changes anything.

Pre-flight reportvoidscape preview

$ voidscape.py preview "clip.mp4" --tier both

source scanduration + captions
frame plancount + vision tokens
transcription pathlocal / cloud / download
consent staterequired if applicable
decisionvisible before read
Nothing is impliedGATEDAn API key in the environment is not consent. A cloud path or first model download must be approved explicitly.
// Use cases

See what becomes evidence.

One workflow, ten useful outcomes. The reel pauses when you choose what to inspect.

Showing use case 1 of 10.

Video + audio

Turn a tutorial into a cited note.

Read the frames and transcript together, then keep the moments that support the answer.

Evidence: [MM:SS]
Auto
See complete capability status

What works now. What comes next.

Available tools, work in progress, and what comes after. Sequenced milestones, not a promise to build everything in a day.

01 / Available now — read the media you already have

Local videos, recordings, audio, captions, images, filename-ordered carousels, chat exports, articles, and RSS/Atom feeds share the inspect → preview → read discipline. Supported public video URLs include individual YouTube links; platform access varies. Approved public article and feed fetches create local evidence too. Optional screenshot sidecars preserve capture scope and verify image integrity.

Keep timestamped frames, transcripts, ordered images or entries, and manifests an agent can cite. The CLI and bundled skill preserve separate cloud and model-download approvals. These are the reading foundations; saved-account workflows have their own verification gates.

02 / In progress — prove the source workflows

Instagram triage, public Substack/RSS capture, selected article and podcast reads with verified notes, public YouTube selection and notes, and local recording-inbox processing have implementations in the repository. They remain development-only while independent skill, harness, and real-workflow acceptance is completed. Generated files and passing helper tests alone do not prove every agent environment works.

Public-feed verification includes a real podcast and one subscriber-only article correctly recorded as skipped. That does not establish general paywall detection. LinkedIn has local observation capture, verified notes and a project skill; independent harness acceptance remains, and any future live platform work needs a documented approved route. The current focus is verification: reliable browser access, grounded notes, safe resume behavior, installer checks, and release evidence. Follow the current acceptance milestone.

03 / Next — add bounded automation and integrations

Build on what exists: a cloud-disabled local inbox schedule, a documented approved route before any future LinkedIn acquisition, and browser pairing and permission design in the separate bridge. A Windows inbox schedule plan can be reviewed and manually registered; it does not create a task by itself. Each is a separate workstream with its own acceptance gates.

A development-only private YouTube queue helper uses the official Data API and a user-owned playlist, not Watch Later. Its live account flow still needs verification. Easy cron setup is not shipped. See the next milestone; no delivery date is promised.

04 / Later — exploration, not promised

X bookmarks, TikTok favorites, Reddit saves, newsletter collections, more audio adapters, visual change reports, capture benchmarks, multi-model workflows, and a hosted edition are longer-term directions. Each saved source needs its own platform and permission review; public article reading today does not imply private collection capture.

Visual jobs could check an approved page for layout changes or prepare a research digest. First come allowlists, budgets, timeouts, bounded retries, evidence retention, pause controls, and meaningful-change notifications. Iris remains STOPPED for integration review, not because malware has been established: static scan warnings are not evidence of malware. The Codex plugin remains DO NOT INSTALL. Security review gates still apply; neither is an installed capability.

The bright line: Voidscape reads. FollowerManager relationship audits, creator analytics, and LinkedIn job-search tools are separate companion directions, not Voidscape features. Permission to read never implies following, unfollowing, messaging, or publishing.

Explore the later milestone and its dependencies. The offline follower audit is waiting for selected export files.

Choose the simplest effective tool—and keep permission visible

Simplest tool wins. Deterministic code extracts and compares, authorized APIs fetch structured data, and approved browser tools read visible pages. AI joins only when interpretation adds value — captions before transcription, local before paid.

Future automation stays visible by design: history in local files or SQLite, capped compute and API spend, and a clear stop when access expires. Subscription access is not API credit, and installing Voidscape creates no scheduled job and no account permission.

Read the detailed status and boundaries Track completed, current, next and later milestones
Install / first read

Install once. Use it anywhere.

Get the global CLI and bundled agent skill without cloning the repository. No account, API key, or paid backend is required.

Before you start Open PowerShell on Windows or Terminal on macOS/Linux. Voidscape checks FFmpeg and FFprobe before media work.

  1. 01

    Install uv once.

    On Windows, paste this into PowerShell:

    $ winget install --id=astral-sh.uv -e
    macOS or Linux$ curl -LsSf https://astral.sh/uv/install.sh | sh

    Already have uv? Skip this step.

    FFmpeg or FFprobe missing?

    Windows: winget install --id=Gyan.FFmpeg -e. macOS: brew install ffmpeg. Debian/Ubuntu: sudo apt update && sudo apt install ffmpeg.

  2. 02

    Install Voidscape and its agent skill.

    One isolated CLI. One guided skill for Codex and shared agents.

    $ uv tool install https://github.com/RikepilB/void-scape/archive/refs/heads/main.zip
    $ uv tool update-shell
    $ voidscape init

    init installs the bundled agent skill and checks local tools. It never approves cloud processing or a model download. If the command is not recognized yet, open one new terminal.

    Choose an Inbox and Library (optional)$ voidscape customize
  3. 03

    Read your first file.

    Replace meeting.mp4 with a local image, audio file, video, folder, or supported public URL.

    $ voidscape doctor
    $ voidscape inspect "meeting.mp4"
    $ voidscape preview "meeting.mp4"
    $ voidscape read "meeting.mp4" --workdir voidscape-output
Then ask your agentThe evidence is now in voidscape-output. Open voidscape-output/manifest.json and transcript.txt, then inspect frames/. Summarize the recording in three bullets. Support every factual claim with an exact [MM:SS] citation. If the evidence is insufficient, say so.

Three things to know before the first read.

The full FAQ covers setup, evidence, sign-in boundaries, and troubleshooting.

Does Voidscape upload my media?

Not by default. Local reads stay on your machine. Cloud transcription and first model downloads each require a current, separate approval.

What does the agent receive?

Selected frames, ordered text or a transcript, and a manifest that maps every citation back to the source.

What can I read today?

Video, audio, images and local carousels, articles, RSS/Atom, supported public video URLs, and explicit on-demand screenshots or short clips.

Browse all questions

Detailed answers live off the conversion path.