Skip to content

teng-lin/notebooklm-py

notebooklm

Verified

Install, authenticate, troubleshoot, and operate Gemini Notebook through the notebooklm-py CLI or typed async Python API. Use for notebook and source management, grounded chat and research, and artifact generation or download when the user mentions Gemini Notebook, notebooklm-py, the notebooklm CLI, or its Python API. Do not use for the generic Gemini API or unrelated content creation.

FileKindSize
SKILL.mdskill md16.0 KB
examples/bulk-import.pyscript3.4 KB
examples/chat.pyscript6.9 KB
examples/notes.pyscript9.8 KB
examples/quickstart.pyscript2.3 KB
examples/refresh_browser_cookies.pyscript2.9 KB
examples/research-to-podcast.pyscript3.2 KB
examples/video.pyscript5.9 KB
scripts/__init__.pyscript73 B
scripts/_ci_e2e_notebooks.pyscript19.0 KB
scripts/_ci_progress.pyscript2.5 KB
scripts/_ci_rpc_progress.pyscript7.5 KB
scripts/_live_auth_scenarios/__init__.pyscript2.6 KB
scripts/_live_auth_scenarios/_contract.pyscript1.9 KB
scripts/_live_auth_scenarios/browser_refresh.pyscript3.1 KB
scripts/_live_auth_scenarios/crash_safe_writer.pyscript1.9 KB
scripts/_live_auth_scenarios/master_token_recovery.pyscript3.3 KB
scripts/_live_auth_scenarios/mcp_recovery.pyscript3.0 KB
scripts/_live_auth_scenarios/rest_recovery.pyscript5.9 KB
scripts/_live_auth_scenarios/sibling_concurrent_reload.pyscript3.9 KB
scripts/_live_auth_scenarios/storage_reload.pyscript2.9 KB
scripts/_onetime_rescrub_cookies.pyscript6.6 KB
scripts/_onetime_retarget_cassette_hosts.pyscript8.5 KB
scripts/_strip_audit_refs.pyscript15.9 KB
scripts/_tracked_files.pyscript872 B
scripts/aggregate_ci_e2e_outcomes.pyscript10.8 KB
scripts/android_grpc_canary.pyscript26.6 KB
scripts/api-compat-allowlist.jsonconfig163 B
scripts/audit_auth_import_graph.pyscript7.5 KB
scripts/audit_auth_patch_sites.pyscript83.6 KB
scripts/audit_auth_shared_mutations.pyscript41.7 KB
scripts/audit_backend_coupling.pyscript32.8 KB
scripts/audit_public_api_compat.pyscript47.4 KB
scripts/audit_test_suite.pyscript10.7 KB
scripts/capture_mobile_grpc.jsscript5.1 KB
scripts/capture_rpc_registry.pyscript44.5 KB
scripts/check_action_pinning.pyscript6.7 KB
scripts/check_auth_behavior_scenario_policy.pyscript37.1 KB
scripts/check_auth_coverage_delta.pyscript23.2 KB
scripts/check_auth_lifecycle_cleanup_policy.pyscript11.7 KB
scripts/check_base_wheel.pyscript6.3 KB
scripts/check_ci_install_parity.pyscript8.8 KB
scripts/check_claude_md_freshness.pyscript8.0 KB
scripts/check_coverage_thresholds.pyscript8.4 KB
scripts/check_deprecation_targets.pyscript33.1 KB
scripts/check_docs_module_refs.pyscript14.4 KB
scripts/check_rpc_health.pyscript112.0 KB
scripts/check_workflow_permissions.pyscript5.3 KB
scripts/check_workflow_secret_gates.pyscript40.4 KB
scripts/decode_mobile_grpc.pyscript7.2 KB
scripts/diagnose_get_notebook.pyscript9.1 KB
scripts/extract_blutter_grpc_signatures.pyscript7.6 KB
scripts/live_auth_matrix.pyscript40.2 KB
scripts/manage_ci_e2e_notebooks.pyscript67.4 KB
scripts/materialize_ci_auth.pyscript8.0 KB
scripts/mcp_live_smoke.pyexecutablescript224 B
scripts/parse_pbenums.pyscript8.6 KB
scripts/parse_pbschema.pyscript11.8 KB
scripts/regen_baselines.pyscript2.7 KB
scripts/regenerate_android_protos.pyscript16.3 KB
scripts/rescrub-cassettes.pyscript13.3 KB
scripts/scrub_rpc_har.pyscript9.4 KB
scripts/select_ci_account.pyscript4.8 KB
scripts/stress_fault_server.pyscript20.6 KB
scripts/test_taxonomy_inventory.pyscript16.1 KB
scripts/verify_ci_artifacts.pyscript35.3 KB

scripts/capture_mobile_grpc.js

View on GitHub
#!/usr/bin/env node

"use strict";

const assert = require("assert");
const fs = require("fs");
const os = require("os");
const path = require("path");
const zlib = require("zlib");

const mockttpModule =
    process.env.NOTEBOOKLM_MOCKTTP_MODULE || "/tmp/notebooklm-mockttp/node_modules/mockttp";
const { getLocal } = require(mockttpModule);

const host = "notebooklm-pa.googleapis.com";
const upstreamIp = process.env.NOTEBOOKLM_UPSTREAM_IP;
const outputDir = process.env.NOTEBOOKLM_CAPTURE_DIR || "/tmp/notebooklm-mobile-grpc";
const listenPort = Number(process.env.NOTEBOOKLM_CAPTURE_PORT || "8081");
const httpToolkitConfig =
    process.env.HTTPTOOLKIT_CONFIG_DIR ||
    path.join(os.homedir(), "Library", "Preferences", "httptoolkit");
const requests = new Map();
let nextId = 0;

if (!upstreamIp) {
    throw new Error("NOTEBOOKLM_UPSTREAM_IP is required; resolve it through DNS-over-HTTPS");
}

fs.mkdirSync(outputDir, { recursive: true, mode: 0o700 });
fs.chmodSync(outputDir, 0o700);

function grpcFrames(body, encoding) {
    const frames = [];
    let offset = 0;
    while (offset < body.length) {
        if (offset + 5 > body.length) throw new Error(`truncated header at ${offset}`);
        const compressed = body[offset];
        const size = body.readUInt32BE(offset + 1);
        offset += 5;
        if (offset + size > body.length) throw new Error(`truncated message at ${offset}`);
        let frame = body.subarray(offset, offset + size);
        offset += size;
        if (compressed) {
            if (encoding !== "gzip") throw new Error(`unsupported encoding: ${encoding}`);
            frame = zlib.gunzipSync(frame);
        }
        frames.push(frame);
    }
    return frames;
}

function dump(id, method, direction, body, encoding, extra = {}) {
    let frames = [];
    let frameError;
    try {
        frames = grpcFrames(body, encoding);
    } catch (error) {
        frameError = error.message;
    }

    const safeMethod = method.replace(/[^A-Za-z0-9_.-]/g, "_");
    const files = frames.map((frame, index) => {
        const filename = `${id}_${safeMethod}.${direction}.${index}.pb`;
        fs.writeFileSync(path.join(outputDir, filename), frame, { mode: 0o600 });
        return { file: filename, size: frame.length };
    });

    let rawFile;
    if (frameError) {
        rawFile = `${id}_${safeMethod}.${direction}.raw`;
        fs.writeFileSync(path.join(outputDir, rawFile), body, { mode: 0o600 });
    }

    const record = {
        id,
        method,
        direction,
        frames: files,
        frame_error: frameError,
        raw_file: rawFile,
        ...extra,
    };
    fs.appendFileSync(path.join(outputDir, "index.jsonl"), `${JSON.stringify(record)}\n`, {
        mode: 0o600,
    });
    console.log(
        `${id} ${direction} ${method} ${files.map((file) => file.size).join(",") || "empty"}`
    );
}

async function main() {
    const server = getLocal({
        https: {
            keyPath: path.join(httpToolkitConfig, "ca.key"),
            certPath: path.join(httpToolkitConfig, "ca.pem"),
        },
        http2: true,
        recordTraffic: false,
        maxBodySize: 100 * 1024 * 1024,
    });

    await server.start(listenPort);
    await server.on("request", (request) => {
        if (
            request.destination.hostname !== host ||
            !String(request.headers["content-type"]).startsWith("application/grpc")
        ) {
            return;
        }
        const id = String(++nextId).padStart(3, "0");
        const method = request.path.split("/").pop();
        requests.set(request.id, { id, method });
        dump(id, method, "request", request.body.buffer, request.headers["grpc-encoding"], {
            path: request.path,
            http_version: request.httpVersion,
        });
    });
    await server.on("response", (response) => {
        const request = requests.get(response.id);
        if (!request) return;
        dump(
            request.id,
            request.method,
            "response",
            response.body.buffer,
            response.headers["grpc-encoding"],
            {
                status_code: response.statusCode,
                grpc_status:
                    response.trailers["grpc-status"] || response.headers["grpc-status"],
            }
        );
        requests.delete(response.id);
    });

    await server.forAnyRequest().forHostname(host).thenPassThrough({
        transformRequest: {
            replaceHost: { targetHost: `${upstreamIp}:443`, updateHostHeader: false },
        },
        ignoreHostHttpsErrors: true,
    });
    await server.forUnmatchedRequest().thenPassThrough();

    console.log(`Capturing ${host} gRPC on :${listenPort}; output: ${outputDir}`);
    console.warn("Captured protobuf bodies can contain private notebook data. Do not commit them.");
    for (const signal of ["SIGINT", "SIGTERM"]) {
        process.once(signal, async () => {
            await server.stop();
            process.exit(0);
        });
    }
}

assert.deepStrictEqual(grpcFrames(Buffer.from("0000000003616263", "hex")), [
    Buffer.from("abc"),
]);
main().catch((error) => {
    console.error(error);
    process.exit(1);
});
deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall