Files and folders

Your meeting library is a folder of ordinary files. Finder and Obsidian show only the files written for you to read; MeetCap keeps its own data in hidden folders named .meetcap. Recordings and speech recognition are kept outside the library, on this computer.

For what the library is and how it syncs, see Your meeting library.

The meeting library

<meeting library>/
├── glossary.md
├── .meetcap/
└── 20261013-0930-weekly-sync-k3x9/
    ├── meeting.md
    ├── meeting.zh.md
    ├── summaries.md
    ├── transcript.md
    └── .meetcap/

Each meeting has its own folder. Its name is the date and time the meeting started, the title, and four random characters. The random characters keep two Macs from making folders with the same name. Renaming a meeting doesn’t rename its folder.

Files you read

MeetCap writes these files from its data and writes them again when something changes, such as a speaker’s name or the minutes. Don’t edit them by hand: your changes are lost the next time. To keep your own notes, write them in a separate note and link to the meeting.

File	What it is
meeting.md	The meeting note: the date and time, who spoke, tags, the minutes, and a link to the transcript. Each point in the minutes links to the line it came from.
meeting.zh.md, meeting.en.md	The meeting note in the other language. Only there if the meeting has minutes in that language.
transcript.md	The transcript: who spoke, when, and what they said, one line at a time.
summaries.md	The summaries written during the meeting, each with its background. Only there if the meeting had any.

Files you can edit

File	What it is
glossary.md	Names and terms that come up in your meetings, as a table: the spelling, the ways it gets misheard, and a note. You can edit it in any editor, or in Settings › Glossary. When MeetCap adds terms after a meeting, it keeps your rows. See Get names and terms right with the glossary.

MeetCap’s own data

Everything in a .meetcap folder is MeetCap’s own data. Don’t edit, move, or delete these files by hand. To change a meeting, use the app, the meetcap command, or your agent.

In the .meetcap folder at the top of the library:

File	What it is
config.json	The library’s settings: its language, how the minutes are written, default tags, the summary interval, and how long recordings are kept.
voiceprints.json	The voices of the people in People.
enroll/	The voice clips each voice was made from, one folder for each person, about 1 MB each. MeetCap uses them to rebuild the voices after an update.

In each meeting’s .meetcap folder:

File	What it is
meta.json	The meeting’s title, start and end times, what was recorded, and on which computer.
state.json	What the meeting is doing now, such as recording or processing, and any summaries or minutes still to be written.
context.json	The meeting’s background: who attends, the agenda, the terms it uses, and where the last meeting left off.
speakers.json	Each speaker’s number in this meeting and the name you gave them.
transcript.jsonl	The transcript as data. transcript.md is written from it.
summaries.jsonl	The summaries as data.
minutes.zh.json, minutes.en.json	The minutes as data, one file for each language. The meeting note is written from them.
view.jsonl	The lines as the app shows them now. MeetCap can rebuild it from the other files.
audio/	A list of the recording’s files and where each line is in them. The recording itself is on the computer that made it.
log/	A record of what happened while the meeting was recorded and processed. It never contains what was said.
run-…/	A folder an agent works in while it writes the summaries or minutes.

Files ending in .lock stop two programs from changing the same file at once.

On this computer

These are outside the library and don’t sync.

Location	What it is
/Applications/MeetCap.app	The app. If /Applications can’t be written to, the install command puts it in ~/Applications instead.
~/.local/bin/meetcap	The meetcap command.
~/Library/Application Support/MeetCap/audio/	Recordings, one folder for each meeting. See Recordings stay on your computer.
~/Library/Application Support/MeetCap/models/	Speech recognition model: about 500 MB once installed. The local model, if you download it, adds about 5.2 GB.
~/Library/Application Support/MeetCap/config.json	Which meeting library this computer uses.
~/Library/LaunchAgents/dev.seacen.meetcap.schedule.*.plist	Your recording schedules, one file for each.
Keychain, item named MeetCap	Your API key, if you use your own.

If you delete a meeting’s folder in Finder, its recording stays on this computer. To find and remove recordings like these, run meetcap audio gc, then meetcap audio gc --confirm. To delete a meeting completely, delete it in the meeting list instead.