# AutoShow

AutoShow turns audio, video, and documents into transcripts, structured text, narrated audio, images, music, and short video outputs.

Canonical site URL: https://staging.auto.show
Repository: https://github.com/ajcwebdev/autoshow-bun

Start here:
- https://staging.auto.show/
- https://staging.auto.show/llms.txt
- https://staging.auto.show/sitemap.md
- https://staging.auto.show/api

Public machine-readable routes:
- https://staging.auto.show/ (text/html) - Public overview of AutoShow capabilities, supported inputs, and the processing pipeline.
- https://staging.auto.show/llms.txt (text/plain) - Cheap plain-text orientation for agents and operators.
- https://staging.auto.show/sitemap.md (text/markdown) - Machine-readable markdown index for public routes, operator routes, and API entry points.
- https://staging.auto.show/sitemap.xml (application/xml) - Search-oriented sitemap for public crawlable pages and machine-readable discovery routes.
- https://staging.auto.show/robots.txt (text/plain) - Crawler policy that keeps protected routes blocked while allowing discovery endpoints.
- https://staging.auto.show/api (application/json) - Public JSON overview of the AutoShow API with auth expectations and next actions.
- https://staging.auto.show/api/health (application/json) - Public JSON health endpoint used by deploy checks and test runners.
- https://staging.auto.show/api/process/document-capabilities (application/json) - Public JSON capabilities surface for document extraction providers and current runtime support.

Authenticated operator routes:
- https://staging.auto.show/login [public] - Magic-link sign-in page for interactive operators.
- https://staging.auto.show/create [session] - Authenticated UI for verifying inputs, uploading files, and starting processing jobs.
- https://staging.auto.show/show-notes [session] - Authenticated dashboard for completed jobs and generated assets.

Key API endpoints:
- GET /api [public] returns application/json - Machine-readable API overview with endpoint metadata and next actions.
- GET /api/health [public] returns application/json - Read-only service health endpoint.
- GET /api/process/document-capabilities [public] returns application/json - Current server-side document extraction capability matrix.
- POST /api/download/verify-url [session] accepts application/json; returns application/json - Validate a public source URL and return metadata before job submission.
- POST /api/download/upload [session] accepts multipart/form-data; returns application/json - Single-request file upload endpoint for local sources.
- POST /api/download/upload-chunk [session] accepts multipart/form-data; returns application/json - Chunked upload endpoint for large local files.
- POST /api/process [session] accepts multipart/form-data; returns application/json - Start a background job for transcription or document extraction plus optional generation steps.
- GET /api/jobs/{id} [session] returns application/json - Fetch current job progress until a show note is completed or the job fails.
- DELETE /api/show-notes/{id} [session] returns application/json - Delete a show note record and trigger background asset cleanup.

Repository markdown docs:
- https://raw.githubusercontent.com/ajcwebdev/autoshow-bun/main/README.md - Setup, feature summary, CLI/docs index, and discovery route references.
- https://raw.githubusercontent.com/ajcwebdev/autoshow-bun/main/docs/api/README.md - Top-level API docs for auth, endpoints, errors, and environment expectations.
- https://raw.githubusercontent.com/ajcwebdev/autoshow-bun/main/docs/tests.md - Canonical test commands and shared infrastructure notes.

Operational notes:
- Most write or user-specific API routes require a Better Auth session cookie.
- /api/health and /api/process/document-capabilities are public read-only JSON routes.
- Use /api for the JSON discovery document and /sitemap.md for the broader markdown operator index.