Turn a tutorial into a cited note.
Read the frames and transcript together, then keep the moments that support the answer.
Evidence: [MM:SS]Voidscape reads video, audio, images, articles, and feeds through one visible sequence: inspect, preview, read.
One visible sequence turns an opaque source into evidence an agent can verify.
See what the source contains.
Check cost, dependencies, and consent.
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.
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.
$ voidscape.py preview "clip.mp4" --tier both
One workflow, ten useful outcomes. The reel pauses when you choose what to inspect.
Showing use case 1 of 10.
Read the frames and transcript together, then keep the moments that support the answer.
Evidence: [MM:SS]Preserve every original image, natural filename order, and position-specific citation.
Evidence: [image 1]Transcribe locally, keep the source timeline, and let an agent compare ideas with the words actually said.
Evidence: [MM:SS]Read local Markdown, HTML, text, RSS, or Atom without flattening where each entry came from.
Evidence: [article N] · [entry N]Combine selected frames with speech so an agent can trace what changed instead of guessing from a report.
Evidence: frames + [MM:SS]Bring a supported URL into the same visible gates, then keep local evidence instead of another forgotten tab.
Evidence: local bundleA browser-connected agent works from tabs you approve and hands confirmed public URLs into the local queue. It never touches your credentials, cookies, or browser storage.
Evidence: queued sourceA one-click browser extension direction: save the video or post in front of you into your Inbox, then run the same inspect → preview → read gates. Planned, not promised.
Direction: plannedThe read bundle becomes Markdown notes, HTML reports, spreadsheets, Word docs, or PDFs agent-side — every claim traces back to a frame or timestamp.
Outputs: md · html · xlsx · docx · pdfExport any conversation and read it as ordered, citable messages. Media is referenced for its own read — no login, no cloud, no account access.
Evidence: [message N]Available tools, work in progress, and what comes after. Sequenced milestones, not a promise to build everything in a day.
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.
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.
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.
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.
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.
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.
uv once.On Windows, paste this into PowerShell:
$ winget install --id=astral-sh.uv -e
$ curl -LsSf https://astral.sh/uv/install.sh | shAlready have uv? Skip this step.
Windows: winget install --id=Gyan.FFmpeg -e. macOS: brew install ffmpeg. Debian/Ubuntu: sudo apt update && sudo apt install ffmpeg.
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.
$ voidscape customizeReplace 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
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.
The full FAQ covers setup, evidence, sign-in boundaries, and troubleshooting.
Not by default. Local reads stay on your machine. Cloud transcription and first model downloads each require a current, separate approval.
Selected frames, ordered text or a transcript, and a manifest that maps every citation back to the source.
Video, audio, images and local carousels, articles, RSS/Atom, supported public video URLs, and explicit on-demand screenshots or short clips.
Detailed answers live off the conversion path.