Skip to main content

Structure


meetings/
├── bin/
│   ├── meeting-start        # starts recording + live transcription
│   ├── meeting-stop         # stops recording, asks for meeting name, renames files
│   ├── meeting-follow       # follow transcript while it is being written
│   └── summarize-meeting    # create post-meeting summaries
│
├── lib/
│   ├── audio.sh             # defines the system audio monitor source
│   ├── paths.sh             # creates session dirs + defines file paths
│   └── whisper.sh           # whisper.cpp binary, model, ASR parameters
│
└── recordings/
    └── 2025-03-24_1930/     # session directory (created on meeting-start)
        ├── audio.wav        # raw system audio recording
        ├── transcript.txt  # live transcript (grows during meeting)
        ├── meta.env        # session metadata (PIDs, language, timestamps)
        ├── 2025-03-24T1930_project-sync_transcript.txt
        ├── 2025-03-24T1930_project-sync_audio.wav
        └── summary.md      # created by summarize-meeting

Description of Paths and Scripts

Paths

Path: meeting/slib/meetings/bin/

    Executable scripts. 

    Path: meetings/lib/

    • Scripts to be included in the executable scripts. 

    Path: meetings/bin/

      Executable scripts. 

      Path: meetings/recordings/

      • Subdirectories (ISO timestamp format)
        • Audio files (to be deleted after the transcript has been written)
        • transcript.txt (renamed and timestamped by the meeting-stop script)
        • meta.env (Meeting meta information)
          • PIDs
          • language used
          • the meeting's timestamps
        • summary.md (meeting summary in Markdown format)
      Scripts

      Script:Script: meetingmeetings/lib/audio.sh

        Provides the name of the system audio device

        Script: meetings/lib/paths.sh

        Creates: 

        • Session Directory
        • Session Files 
          • audio.wav

          • transcript.txt

          • meta.env

        • Timestamps (ISO)

        and

        • Provides path information for all scripts

        Script: meetings/lib/whisper.sh

        Contains:

        • Path to whisper.cpp
        • the model (currently ggml-base.bin
        • ASR parameter used