# pycamtasia

A Python library for programmatically creating, reading, and manipulating TechSmith Camtasia video projects.

**Key features:**

- Load, modify, and save `.cmproj` / `.tscproj` project files
- Add clips, effects, transitions, and annotations
- Undo/redo with JSON Patch diffs
- Strong typing with enums and TypedDicts
- Export to EDL, CSV, SRT, and JSON
- 1700+ tests, 100% coverage, mypy-clean
- Validated against 86 official TechSmith sample projects

## Getting Started

```{toctree}
:maxdepth: 2

quickstart
guides/getting-started
```

## Guides

```{toctree}
:maxdepth: 2

guides/convenience-api
guides/speed-change
guides/audio-video-sync
guides/template-projects
guides/transcripts
guides/camtasia-rev
guides/undo-redo
guides/type-safety
```

## API Reference

```{toctree}
:maxdepth: 2

api/project
api/timing
api/types
api/media_bin
api/timeline
api/clips
api/effects
api/transitions
api/markers
api/captions
api/audiate
api/operations
api/history
api/screenplay
api/builders
api/export
api/validation
```

## Project

```{toctree}
:maxdepth: 1

changelog
```