otterai-cli 0.1.0__tar.gz

otterai_cli-0.1.0/.git-blame-ignore-revs

@@ -0,0 +1,4 @@
+9a522cccf8902c8fa45b28c6a8639e2e588f9ee5
+c12e0c0bcd80753eda3e3e20f5191df5ba6e9624
+a44301791d7b34fc61c80d0a79c753a5e7439b99
+23c0d04d7774b8345ccdfe87445ef0340fd9a71f

otterai_cli-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,18 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v7
+      - run: uvx hatch build
+      - uses: pypa/gh-action-pypi-publish@release/v1

otterai_cli-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,25 @@
+name: Test
+
+on:
+    push:
+        branches:
+            - main
+    pull_request:
+        branches:
+            - "*"
+
+jobs:
+    test:
+        runs-on: ubuntu-latest
+        steps:
+            - name: Checkout code
+              uses: actions/checkout@v4
+
+            - name: Set up uv
+              uses: astral-sh/setup-uv@v7
+
+            - name: Install dependencies
+              run: make init-dev
+
+            - name: Run tests
+              run: make test

otterai_cli-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.egg-info/
+build/
+dist/
+.coverage
+cov.xml
+.env
+.venv/
+tests/output/

otterai_cli-0.1.0/.prettierrc

@@ -0,0 +1,3 @@
+{
+    "tabWidth": 4
+}

otterai_cli-0.1.0/.python-version

@@ -0,0 +1 @@
+3.14

otterai_cli-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2021 Chad Lohrli
+Copyright (c) 2025 Eric Chan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

otterai_cli-0.1.0/Makefile

@@ -0,0 +1,19 @@
+.PHONY: init-dev format lint test
+
+init-dev:
+	uv venv || true
+	uv pip install .[dev]
+
+format:
+	uv run ruff format .
+
+lint:
+	uv run ruff check .
+
+test:
+	rm -f cov.xml ||:
+	uv run pytest -s --cov=src/otterai \
+		--cov-report=lcov:lcov.info \
+		--cov-report=xml:cov.xml \
+		tests/
+	rm -f lcov.info .coverage ||:

otterai_cli-0.1.0/PKG-INFO

@@ -0,0 +1,207 @@
+Metadata-Version: 2.4
+Name: otterai-cli
+Version: 0.1.0
+Summary: Unofficial Otter.ai CLI
+Project-URL: Homepage, https://github.com/ericchan-su/otterai-cli
+Project-URL: Repository, https://github.com/ericchan-su/otterai-cli
+Project-URL: Issues, https://github.com/ericchan-su/otterai-cli/issues
+Author-email: Eric Chan <eric.kahei.chan@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0
+Requires-Dist: keyring>=23.0
+Requires-Dist: requests
+Requires-Dist: requests-toolbelt
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: responses; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# otterai-cli
+
+An unofficial command-line interface for [Otter.ai](https://otter.ai).
+
+> **Note:** This project is not affiliated with or endorsed by Otter.ai / Aisense Inc.
+
+## Requirements
+
+- Python 3.10+
+
+## Installation
+
+```bash
+uv tool install otterai-cli
+```
+
+This makes the `otter` command available globally.
+
+Or run directly without installing:
+
+```bash
+uvx --from otterai-cli otter --help
+```
+
+## Setup
+
+```bash
+otter login
+```
+
+This prompts for your Otter.ai email and password. Credentials are saved to `~/.otterai/config.json`.
+
+### Alternative methods
+
+**Environment variables** (take precedence over config file):
+
+```bash
+export OTTERAI_USERNAME="your-email@example.com"
+export OTTERAI_PASSWORD="your-password"
+```
+
+### Auth commands
+
+```bash
+otter user      # check current user
+otter logout    # remove saved credentials
+```
+
+## Usage
+
+```bash
+otter speeches list                          # list all speeches
+otter speeches list --days 7                 # last 7 days
+otter speeches list --folder "Work"          # by folder name
+otter speeches get SPEECH_ID                 # get speech details + transcript
+otter speeches download SPEECH_ID -f txt     # download as txt, pdf, mp3, docx, or srt
+otter speeches search "keyword" SPEECH_ID    # search within a speech
+otter speakers list                          # list all speakers
+otter folders list                           # list all folders
+```
+
+Run `otter --help` or `otter <command> --help` for more options.
+
+### Important: Speech IDs (otid vs speech_id)
+
+Otter.ai speeches have two identifiers:
+- **`speech_id`** (e.g. `22WB27HAEBEJYFCA`) -- internal ID, does **NOT** work with API endpoints
+- **`otid`** (e.g. `jqb7OHo6mrHtCuMkyLN0nUS8mxY`) -- the ID used in all API calls
+
+All CLI commands that accept a `SPEECH_ID` argument expect the **otid** value. Use `otter speeches list` to find otids, or `otter speeches list --json | jq '.speeches[].otid'` for just the IDs.
+
+### Speeches
+
+```bash
+# List all speeches
+otter speeches list
+
+# List with options
+otter speeches list --page-size 10 --source owned
+
+# List speeches from the last N days
+otter speeches list --days 2
+
+# List speeches in a specific folder (by name or ID)
+otter speeches list --folder "CoverNode"
+
+# Get a specific speech
+otter speeches get SPEECH_ID
+
+# Search within a speech
+otter speeches search "search query" SPEECH_ID
+
+# Download a speech (formats: txt, pdf, mp3, docx, srt)
+otter speeches download SPEECH_ID --format txt
+
+# Upload an audio file
+otter speeches upload recording.mp4
+
+# Move to trash
+otter speeches trash SPEECH_ID
+
+# Rename a speech
+otter speeches rename SPEECH_ID "New Title"
+
+# Move speeches to a folder (by name or ID)
+otter speeches move SPEECH_ID --folder "CoverNode"
+otter speeches move ID1 ID2 ID3 --folder "CoverNode"
+
+# Move to a new folder (auto-create if it doesn't exist)
+otter speeches move SPEECH_ID --folder "New Folder" --create
+```
+
+### Speakers
+
+```bash
+# List all speakers
+otter speakers list
+
+# Create a new speaker
+otter speakers create "Speaker Name"
+
+# Tag a speaker on transcript segments
+otter speakers tag SPEECH_ID SPEAKER_ID
+otter speakers tag SPEECH_ID SPEAKER_ID --all
+```
+
+### Folders and Groups
+
+```bash
+# List folders
+otter folders list
+
+# Create a folder
+otter folders create "My Folder"
+
+# Rename a folder
+otter folders rename FOLDER_ID "New Name"
+
+# List groups
+otter groups list
+```
+
+### Configuration
+
+```bash
+# Show current config
+otter config show
+
+# Clear saved config
+otter config clear
+```
+
+### JSON Output
+
+Most commands support `--json` flag for machine-readable output:
+
+```bash
+otter speeches list --json
+otter speakers list --json
+```
+
+## Development
+
+```bash
+uv sync --dev        # install dependencies
+uv run pytest        # run tests
+```
+
+## Acknowledgements
+
+Based on [gmchad/otterai-api](https://github.com/gmchad/otterai-api) by Chad Lohrli, with CLI functionality from [PR #9](https://github.com/gmchad/otterai-api/pull/9) by [@andrewfurman](https://github.com/andrewfurman).
+
+## License
+
+MIT

otterai_cli-0.1.0/README.md

@@ -0,0 +1,175 @@
+# otterai-cli
+
+An unofficial command-line interface for [Otter.ai](https://otter.ai).
+
+> **Note:** This project is not affiliated with or endorsed by Otter.ai / Aisense Inc.
+
+## Requirements
+
+- Python 3.10+
+
+## Installation
+
+```bash
+uv tool install otterai-cli
+```
+
+This makes the `otter` command available globally.
+
+Or run directly without installing:
+
+```bash
+uvx --from otterai-cli otter --help
+```
+
+## Setup
+
+```bash
+otter login
+```
+
+This prompts for your Otter.ai email and password. Credentials are saved to `~/.otterai/config.json`.
+
+### Alternative methods
+
+**Environment variables** (take precedence over config file):
+
+```bash
+export OTTERAI_USERNAME="your-email@example.com"
+export OTTERAI_PASSWORD="your-password"
+```
+
+### Auth commands
+
+```bash
+otter user      # check current user
+otter logout    # remove saved credentials
+```
+
+## Usage
+
+```bash
+otter speeches list                          # list all speeches
+otter speeches list --days 7                 # last 7 days
+otter speeches list --folder "Work"          # by folder name
+otter speeches get SPEECH_ID                 # get speech details + transcript
+otter speeches download SPEECH_ID -f txt     # download as txt, pdf, mp3, docx, or srt
+otter speeches search "keyword" SPEECH_ID    # search within a speech
+otter speakers list                          # list all speakers
+otter folders list                           # list all folders
+```
+
+Run `otter --help` or `otter <command> --help` for more options.
+
+### Important: Speech IDs (otid vs speech_id)
+
+Otter.ai speeches have two identifiers:
+- **`speech_id`** (e.g. `22WB27HAEBEJYFCA`) -- internal ID, does **NOT** work with API endpoints
+- **`otid`** (e.g. `jqb7OHo6mrHtCuMkyLN0nUS8mxY`) -- the ID used in all API calls
+
+All CLI commands that accept a `SPEECH_ID` argument expect the **otid** value. Use `otter speeches list` to find otids, or `otter speeches list --json | jq '.speeches[].otid'` for just the IDs.
+
+### Speeches
+
+```bash
+# List all speeches
+otter speeches list
+
+# List with options
+otter speeches list --page-size 10 --source owned
+
+# List speeches from the last N days
+otter speeches list --days 2
+
+# List speeches in a specific folder (by name or ID)
+otter speeches list --folder "CoverNode"
+
+# Get a specific speech
+otter speeches get SPEECH_ID
+
+# Search within a speech
+otter speeches search "search query" SPEECH_ID
+
+# Download a speech (formats: txt, pdf, mp3, docx, srt)
+otter speeches download SPEECH_ID --format txt
+
+# Upload an audio file
+otter speeches upload recording.mp4
+
+# Move to trash
+otter speeches trash SPEECH_ID
+
+# Rename a speech
+otter speeches rename SPEECH_ID "New Title"
+
+# Move speeches to a folder (by name or ID)
+otter speeches move SPEECH_ID --folder "CoverNode"
+otter speeches move ID1 ID2 ID3 --folder "CoverNode"
+
+# Move to a new folder (auto-create if it doesn't exist)
+otter speeches move SPEECH_ID --folder "New Folder" --create
+```
+
+### Speakers
+
+```bash
+# List all speakers
+otter speakers list
+
+# Create a new speaker
+otter speakers create "Speaker Name"
+
+# Tag a speaker on transcript segments
+otter speakers tag SPEECH_ID SPEAKER_ID
+otter speakers tag SPEECH_ID SPEAKER_ID --all
+```
+
+### Folders and Groups
+
+```bash
+# List folders
+otter folders list
+
+# Create a folder
+otter folders create "My Folder"
+
+# Rename a folder
+otter folders rename FOLDER_ID "New Name"
+
+# List groups
+otter groups list
+```
+
+### Configuration
+
+```bash
+# Show current config
+otter config show
+
+# Clear saved config
+otter config clear
+```
+
+### JSON Output
+
+Most commands support `--json` flag for machine-readable output:
+
+```bash
+otter speeches list --json
+otter speakers list --json
+```
+
+## Development
+
+```bash
+uv sync --dev        # install dependencies
+uv run pytest        # run tests
+```
+
+## Acknowledgements
+
+Based on [gmchad/otterai-api](https://github.com/gmchad/otterai-api) by Chad Lohrli, with CLI functionality from [PR #9](https://github.com/gmchad/otterai-api/pull/9) by [@andrewfurman](https://github.com/andrewfurman).
+
+## License
+
+MIT

otterai_cli-0.1.0/pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "otterai-cli"
+version = "0.1.0"
+description = "Unofficial Otter.ai CLI"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "Eric Chan", email = "eric.kahei.chan@gmail.com" },
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "click>=8.0",
+    "keyring>=23.0",
+    "requests",
+    "requests_toolbelt",
+]
+
+[project.urls]
+Homepage = "https://github.com/ericchan-su/otterai-cli"
+Repository = "https://github.com/ericchan-su/otterai-cli"
+Issues = "https://github.com/ericchan-su/otterai-cli/issues"
+
+[project.scripts]
+otter = "otterai.cli:main"
+
+[project.optional-dependencies]
+dev = ["pytest", "pytest-cov", "responses", "ruff"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/otterai"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+strict_markers = true
+
+[tool.coverage.run]
+source = ["src/otterai"]
+
+[tool.coverage.report]
+fail_under = 80
+show_missing = true

otterai_cli-0.1.0/src/otterai/__init__.py

@@ -0,0 +1,4 @@
+import warnings
+
+# Suppress urllib3 NotOpenSSLWarning on macOS systems using LibreSSL
+warnings.filterwarnings("ignore", message=".*urllib3.*OpenSSL.*")

otterai_cli-0.1.0/src/otterai/cli/__init__.py

@@ -0,0 +1,26 @@
+import click
+
+from . import auth
+from .speeches import speeches
+from .speakers import speakers
+from .folders import folders
+from .groups import groups
+from .config_cmd import config
+
+
+@click.group()
+@click.version_option(version="0.1.0", prog_name="otter")
+def main():
+    """OtterAI CLI - Interact with Otter.ai from the command line."""
+    pass
+
+
+# Register top-level commands (login, logout, user)
+auth.register(main)
+
+# Register subcommand groups
+main.add_command(speeches)
+main.add_command(speakers)
+main.add_command(folders)
+main.add_command(groups)
+main.add_command(config)

otterai_cli-0.1.0/src/otterai/cli/auth.py

@@ -0,0 +1,59 @@
+import json
+import sys
+
+import click
+
+from ..client import OtterAIClient
+from ..config import clear_credentials, get_config_path, save_credentials
+from .helpers import get_authenticated_client
+
+
+def register(main: click.Group):
+    main.add_command(login)
+    main.add_command(logout)
+    main.add_command(user)
+
+
+@click.command()
+@click.option("--username", "-u", prompt=True, help="Otter.ai username (email)")
+@click.option(
+    "--password", "-p", prompt=True, hide_input=True, help="Otter.ai password"
+)
+def login(username: str, password: str):
+    """Authenticate with Otter.ai and save credentials."""
+    client = OtterAIClient()
+    result = client.login(username, password)
+
+    if result["status"] != 200:
+        click.echo(f"Login failed: {result.get('data', {})}", err=True)
+        sys.exit(1)
+
+    backend = save_credentials(username, password)
+    user_data = result.get("data", {})
+    click.echo(f"Logged in as {user_data.get('email', username)}")
+    if backend == "keyring":
+        click.echo("Credentials saved to system keyring")
+    else:
+        click.echo(f"Credentials saved to {get_config_path()}")
+
+
+@click.command()
+def logout():
+    """Clear saved credentials."""
+    if clear_credentials():
+        click.echo("Credentials cleared.")
+    else:
+        click.echo("No saved credentials found.")
+
+
+@click.command()
+def user():
+    """Show current user information."""
+    client = get_authenticated_client()
+    result = client.get_user()
+
+    if result["status"] != 200:
+        click.echo(f"Failed to get user: {result}", err=True)
+        sys.exit(1)
+
+    click.echo(json.dumps(result["data"], indent=2))

otterai_cli-0.1.0/src/otterai/cli/config_cmd.py

@@ -0,0 +1,36 @@
+import click
+
+from ..config import clear_credentials, get_config_path, get_credential_backend, load_credentials
+
+
+@click.group("config")
+def config():
+    """Manage CLI configuration."""
+    pass
+
+
+@config.command("show")
+def config_show():
+    """Show current configuration."""
+    username, password = load_credentials()
+    config_path = get_config_path()
+    backend = get_credential_backend()
+
+    click.echo(f"Config file: {config_path}")
+    click.echo(f"Config exists: {config_path.exists()}")
+
+    if username:
+        click.echo(f"Backend: {backend}")
+        click.echo(f"Username: {username}")
+        click.echo(f"Password: {'*' * len(password) if password else 'Not set'}")
+    else:
+        click.echo("Not logged in.")
+
+
+@config.command("clear")
+def config_clear():
+    """Clear saved configuration."""
+    if clear_credentials():
+        click.echo("Configuration cleared.")
+    else:
+        click.echo("No configuration found.")