@vodailoc/kilo-kit-mcp 1.1.0 → 1.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.mcp/kilo-kit.codex-windows.toml +5 -0
- package/LICENSE +190 -190
- package/QUICKSTART.md +265 -255
- package/README.md +290 -266
- package/mcp/README.md +29 -5
- package/mcp/dist/server.js +1 -1
- package/mcp/package.json +1 -2
- package/package.json +3 -2
- package/skills/README.md +647 -647
- package/skills/SKILLS_INDEX.md +139 -139
- package/skills/ai-media/ai-multimodal/.env.example +97 -97
- package/skills/ai-media/ai-multimodal/SKILL.md +357 -357
- package/skills/ai-media/ai-multimodal/references/audio-processing.md +373 -373
- package/skills/ai-media/ai-multimodal/references/image-generation.md +558 -558
- package/skills/ai-media/ai-multimodal/references/video-analysis.md +502 -502
- package/skills/ai-media/ai-multimodal/references/vision-understanding.md +483 -483
- package/skills/ai-media/ai-multimodal/scripts/document_converter.py +395 -395
- package/skills/ai-media/ai-multimodal/scripts/gemini_batch_process.py +480 -480
- package/skills/ai-media/ai-multimodal/scripts/media_optimizer.py +506 -506
- package/skills/ai-media/ai-multimodal/scripts/requirements.txt +26 -26
- package/skills/ai-media/ai-multimodal/scripts/tests/requirements.txt +20 -20
- package/skills/ai-media/ai-multimodal/scripts/tests/test_document_converter.py +299 -299
- package/skills/ai-media/ai-multimodal/scripts/tests/test_gemini_batch_process.py +362 -362
- package/skills/ai-media/ai-multimodal/scripts/tests/test_media_optimizer.py +373 -373
- package/skills/ai-media/media-processing/SKILL.md +358 -358
- package/skills/ai-media/media-processing/references/ffmpeg-encoding.md +358 -358
- package/skills/ai-media/media-processing/references/ffmpeg-filters.md +503 -503
- package/skills/ai-media/media-processing/references/ffmpeg-streaming.md +403 -403
- package/skills/ai-media/media-processing/references/format-compatibility.md +375 -375
- package/skills/ai-media/media-processing/references/imagemagick-batch.md +612 -612
- package/skills/ai-media/media-processing/references/imagemagick-editing.md +623 -623
- package/skills/ai-media/media-processing/scripts/batch_resize.py +342 -342
- package/skills/ai-media/media-processing/scripts/media_convert.py +311 -311
- package/skills/ai-media/media-processing/scripts/requirements.txt +24 -24
- package/skills/ai-media/media-processing/scripts/tests/requirements.txt +2 -2
- package/skills/ai-media/media-processing/scripts/tests/test_batch_resize.py +372 -372
- package/skills/ai-media/media-processing/scripts/tests/test_media_convert.py +259 -259
- package/skills/ai-media/media-processing/scripts/tests/test_video_optimize.py +397 -397
- package/skills/ai-media/media-processing/scripts/video_optimize.py +414 -414
- package/skills/ai-media/screenshot/LICENSE.txt +201 -201
- package/skills/ai-media/screenshot/SKILL.md +267 -267
- package/skills/ai-media/screenshot/agents/openai.yaml +6 -6
- package/skills/ai-media/screenshot/assets/screenshot-small.svg +5 -5
- package/skills/ai-media/screenshot/scripts/ensure_macos_permissions.sh +54 -54
- package/skills/ai-media/screenshot/scripts/macos_display_info.swift +22 -22
- package/skills/ai-media/screenshot/scripts/macos_permissions.swift +40 -40
- package/skills/ai-media/screenshot/scripts/macos_window_info.swift +126 -126
- package/skills/ai-media/screenshot/scripts/take_screenshot.ps1 +163 -163
- package/skills/ai-media/screenshot/scripts/take_screenshot.py +585 -585
- package/skills/ai-media/sora/LICENSE.txt +201 -201
- package/skills/ai-media/sora/SKILL.md +153 -153
- package/skills/ai-media/sora/agents/openai.yaml +6 -6
- package/skills/ai-media/sora/assets/sora-small.svg +4 -4
- package/skills/ai-media/sora/references/cinematic-shots.md +53 -53
- package/skills/ai-media/sora/references/cli.md +248 -248
- package/skills/ai-media/sora/references/codex-network.md +28 -28
- package/skills/ai-media/sora/references/prompting.md +137 -137
- package/skills/ai-media/sora/references/sample-prompts.md +95 -95
- package/skills/ai-media/sora/references/social-ads.md +42 -42
- package/skills/ai-media/sora/references/troubleshooting.md +58 -58
- package/skills/ai-media/sora/references/video-api.md +45 -45
- package/skills/ai-media/sora/scripts/sora.py +970 -970
- package/skills/design/aesthetic/SKILL.md +121 -121
- package/skills/design/aesthetic/assets/design-guideline-template.md +163 -163
- package/skills/design/aesthetic/assets/design-story-template.md +135 -135
- package/skills/design/aesthetic/references/design-principles.md +62 -62
- package/skills/design/aesthetic/references/design-resources.md +75 -75
- package/skills/design/aesthetic/references/micro-interactions.md +53 -53
- package/skills/design/aesthetic/references/storytelling-design.md +50 -50
- package/skills/design/figma/LICENSE.txt +202 -202
- package/skills/design/figma/SKILL.md +42 -42
- package/skills/design/figma/agents/openai.yaml +14 -14
- package/skills/design/figma/assets/figma-small.svg +3 -3
- package/skills/design/figma/assets/icon.svg +28 -28
- package/skills/design/figma/references/figma-mcp-config.md +35 -35
- package/skills/design/figma/references/figma-tools-and-prompts.md +34 -34
- package/skills/design/figma-implement-design/LICENSE.txt +202 -202
- package/skills/design/figma-implement-design/SKILL.md +264 -264
- package/skills/design/figma-implement-design/agents/openai.yaml +14 -14
- package/skills/design/figma-implement-design/assets/figma-small.svg +3 -3
- package/skills/design/figma-implement-design/assets/icon.svg +28 -28
- package/skills/design/frontend-design/SKILL.md +41 -41
- package/skills/design/frontend-design/references/animejs.md +395 -395
- package/skills/design/ui-styling/LICENSE.txt +201 -201
- package/skills/design/ui-styling/SKILL.md +321 -321
- package/skills/design/ui-styling/canvas-fonts/ArsenalSC-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/BigShoulders-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/Boldonse-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/BricolageGrotesque-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/CrimsonPro-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/DMMono-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/EricaOne-OFL.txt +94 -94
- package/skills/design/ui-styling/canvas-fonts/GeistMono-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/Gloock-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/IBMPlexMono-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/InstrumentSans-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/Italiana-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/JetBrainsMono-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/Jura-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/LibreBaskerville-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/Lora-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/NationalPark-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/NothingYouCouldDo-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/Outfit-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/PixelifySans-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/PoiretOne-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/RedHatMono-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/Silkscreen-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/SmoochSans-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/Tektur-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/WorkSans-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/YoungSerif-OFL.txt +93 -93
- package/skills/design/ui-styling/references/canvas-design-system.md +320 -320
- package/skills/design/ui-styling/references/shadcn-accessibility.md +471 -471
- package/skills/design/ui-styling/references/shadcn-components.md +424 -424
- package/skills/design/ui-styling/references/shadcn-theming.md +373 -373
- package/skills/design/ui-styling/references/tailwind-customization.md +483 -483
- package/skills/design/ui-styling/references/tailwind-responsive.md +382 -382
- package/skills/design/ui-styling/references/tailwind-utilities.md +455 -455
- package/skills/design/ui-styling/scripts/requirements.txt +17 -17
- package/skills/design/ui-styling/scripts/shadcn_add.py +292 -292
- package/skills/design/ui-styling/scripts/tailwind_config_gen.py +456 -456
- package/skills/design/ui-styling/scripts/tests/requirements.txt +3 -3
- package/skills/design/ui-styling/scripts/tests/test_shadcn_add.py +266 -266
- package/skills/design/ui-styling/scripts/tests/test_tailwind_config_gen.py +336 -336
- package/skills/engineering/aspnet-core/LICENSE.txt +201 -201
- package/skills/engineering/aspnet-core/SKILL.md +61 -61
- package/skills/engineering/aspnet-core/agents/openai.yaml +5 -5
- package/skills/engineering/aspnet-core/references/_sections.md +40 -40
- package/skills/engineering/aspnet-core/references/apis-minimal-and-controllers.md +81 -81
- package/skills/engineering/aspnet-core/references/data-state-and-services.md +69 -69
- package/skills/engineering/aspnet-core/references/program-and-pipeline.md +103 -103
- package/skills/engineering/aspnet-core/references/realtime-grpc-and-background-work.md +58 -58
- package/skills/engineering/aspnet-core/references/security-and-identity.md +75 -75
- package/skills/engineering/aspnet-core/references/source-map.md +43 -43
- package/skills/engineering/aspnet-core/references/stack-selection.md +63 -63
- package/skills/engineering/aspnet-core/references/testing-performance-and-operations.md +92 -92
- package/skills/engineering/aspnet-core/references/ui-blazor.md +53 -53
- package/skills/engineering/aspnet-core/references/ui-mvc.md +56 -56
- package/skills/engineering/aspnet-core/references/ui-razor-pages.md +55 -55
- package/skills/engineering/aspnet-core/references/versioning-and-upgrades.md +51 -51
- package/skills/engineering/backend-development/SKILL.md +95 -95
- package/skills/engineering/backend-development/references/backend-api-design.md +495 -495
- package/skills/engineering/backend-development/references/backend-architecture.md +454 -454
- package/skills/engineering/backend-development/references/backend-authentication.md +338 -338
- package/skills/engineering/backend-development/references/backend-code-quality.md +659 -659
- package/skills/engineering/backend-development/references/backend-debugging.md +904 -904
- package/skills/engineering/backend-development/references/backend-devops.md +494 -494
- package/skills/engineering/backend-development/references/backend-mindset.md +387 -387
- package/skills/engineering/backend-development/references/backend-performance.md +397 -397
- package/skills/engineering/backend-development/references/backend-security.md +290 -290
- package/skills/engineering/backend-development/references/backend-technologies.md +256 -256
- package/skills/engineering/backend-development/references/backend-testing.md +429 -429
- package/skills/engineering/better-auth/SKILL.md +204 -204
- package/skills/engineering/better-auth/references/advanced-features.md +553 -553
- package/skills/engineering/better-auth/references/database-integration.md +577 -577
- package/skills/engineering/better-auth/references/email-password-auth.md +416 -416
- package/skills/engineering/better-auth/references/oauth-providers.md +430 -430
- package/skills/engineering/better-auth/scripts/better_auth_init.py +521 -521
- package/skills/engineering/better-auth/scripts/requirements.txt +15 -15
- package/skills/engineering/better-auth/scripts/tests/test_better_auth_init.py +421 -421
- package/skills/engineering/code-review/SKILL.md +140 -140
- package/skills/engineering/code-review/references/code-review-reception.md +208 -208
- package/skills/engineering/code-review/references/requesting-code-review.md +104 -104
- package/skills/engineering/code-review/references/verification-before-completion.md +138 -138
- package/skills/engineering/context-engineering/SKILL.md +86 -86
- package/skills/engineering/context-engineering/references/context-compression.md +84 -84
- package/skills/engineering/context-engineering/references/context-degradation.md +93 -93
- package/skills/engineering/context-engineering/references/context-fundamentals.md +75 -75
- package/skills/engineering/context-engineering/references/context-optimization.md +82 -82
- package/skills/engineering/context-engineering/references/evaluation.md +89 -89
- package/skills/engineering/context-engineering/references/memory-systems.md +88 -88
- package/skills/engineering/context-engineering/references/multi-agent-patterns.md +90 -90
- package/skills/engineering/context-engineering/references/project-development.md +97 -97
- package/skills/engineering/context-engineering/references/tool-design.md +86 -86
- package/skills/engineering/context-engineering/scripts/compression_evaluator.py +329 -329
- package/skills/engineering/context-engineering/scripts/context_analyzer.py +294 -294
- package/skills/engineering/databases/SKILL.md +232 -232
- package/skills/engineering/databases/references/mongodb-aggregation.md +447 -447
- package/skills/engineering/databases/references/mongodb-atlas.md +465 -465
- package/skills/engineering/databases/references/mongodb-crud.md +408 -408
- package/skills/engineering/databases/references/mongodb-indexing.md +442 -442
- package/skills/engineering/databases/references/postgresql-administration.md +594 -594
- package/skills/engineering/databases/references/postgresql-performance.md +527 -527
- package/skills/engineering/databases/references/postgresql-psql-cli.md +467 -467
- package/skills/engineering/databases/references/postgresql-queries.md +475 -475
- package/skills/engineering/databases/scripts/db_backup.py +502 -502
- package/skills/engineering/databases/scripts/db_migrate.py +414 -414
- package/skills/engineering/databases/scripts/db_performance_check.py +444 -444
- package/skills/engineering/databases/scripts/requirements.txt +20 -20
- package/skills/engineering/databases/scripts/tests/requirements.txt +4 -4
- package/skills/engineering/databases/scripts/tests/test_db_backup.py +340 -340
- package/skills/engineering/databases/scripts/tests/test_db_migrate.py +277 -277
- package/skills/engineering/databases/scripts/tests/test_db_performance_check.py +370 -370
- package/skills/engineering/diagnose/SKILL.md +117 -117
- package/skills/engineering/diagnose/scripts/hitl-loop.template.sh +41 -41
- package/skills/engineering/docs-seeker/SKILL.md +207 -207
- package/skills/engineering/docs-seeker/WORKFLOWS.md +505 -505
- package/skills/engineering/docs-seeker/references/best-practices.md +632 -632
- package/skills/engineering/docs-seeker/references/documentation-sources.md +461 -461
- package/skills/engineering/docs-seeker/references/error-handling.md +621 -621
- package/skills/engineering/docs-seeker/references/limitations.md +821 -821
- package/skills/engineering/docs-seeker/references/performance.md +574 -574
- package/skills/engineering/docs-seeker/references/tool-selection.md +262 -262
- package/skills/engineering/frontend-development/SKILL.md +398 -398
- package/skills/engineering/frontend-development/resources/common-patterns.md +330 -330
- package/skills/engineering/frontend-development/resources/complete-examples.md +871 -871
- package/skills/engineering/frontend-development/resources/component-patterns.md +501 -501
- package/skills/engineering/frontend-development/resources/data-fetching.md +766 -766
- package/skills/engineering/frontend-development/resources/file-organization.md +501 -501
- package/skills/engineering/frontend-development/resources/loading-and-error-states.md +500 -500
- package/skills/engineering/frontend-development/resources/performance.md +405 -405
- package/skills/engineering/frontend-development/resources/routing-guide.md +363 -363
- package/skills/engineering/frontend-development/resources/styling-guide.md +427 -427
- package/skills/engineering/frontend-development/resources/typescript-standards.md +417 -417
- package/skills/engineering/improve-codebase-architecture/DEEPENING.md +37 -37
- package/skills/engineering/improve-codebase-architecture/INTERFACE-DESIGN.md +44 -44
- package/skills/engineering/improve-codebase-architecture/LANGUAGE.md +53 -53
- package/skills/engineering/improve-codebase-architecture/SKILL.md +71 -71
- package/skills/engineering/openai-docs/LICENSE.txt +201 -201
- package/skills/engineering/openai-docs/SKILL.md +69 -69
- package/skills/engineering/openai-docs/agents/openai.yaml +14 -14
- package/skills/engineering/openai-docs/assets/openai-small.svg +3 -3
- package/skills/engineering/openai-docs/references/gpt-5p4-prompting-guide.md +433 -433
- package/skills/engineering/openai-docs/references/latest-model.md +35 -35
- package/skills/engineering/openai-docs/references/upgrading-to-gpt-5p4.md +164 -164
- package/skills/engineering/playwright/LICENSE.txt +201 -201
- package/skills/engineering/playwright/NOTICE.txt +14 -14
- package/skills/engineering/playwright/SKILL.md +147 -147
- package/skills/engineering/playwright/agents/openai.yaml +6 -6
- package/skills/engineering/playwright/assets/playwright-small.svg +3 -3
- package/skills/engineering/playwright/references/cli.md +116 -116
- package/skills/engineering/playwright/references/workflows.md +95 -95
- package/skills/engineering/playwright/scripts/playwright_cli.sh +25 -25
- package/skills/engineering/playwright-interactive/LICENSE.txt +201 -201
- package/skills/engineering/playwright-interactive/NOTICE.txt +13 -13
- package/skills/engineering/playwright-interactive/SKILL.md +689 -689
- package/skills/engineering/playwright-interactive/agents/openai.yaml +6 -6
- package/skills/engineering/playwright-interactive/assets/playwright-small.svg +3 -3
- package/skills/engineering/render-deploy/LICENSE.txt +201 -201
- package/skills/engineering/render-deploy/SKILL.md +479 -479
- package/skills/engineering/render-deploy/agents/openai.yaml +14 -14
- package/skills/engineering/render-deploy/assets/docker.yaml +62 -62
- package/skills/engineering/render-deploy/assets/go-api.yaml +35 -35
- package/skills/engineering/render-deploy/assets/nextjs-postgres.yaml +35 -35
- package/skills/engineering/render-deploy/assets/node-express.yaml +25 -25
- package/skills/engineering/render-deploy/assets/python-django.yaml +89 -89
- package/skills/engineering/render-deploy/assets/render-small.svg +3 -3
- package/skills/engineering/render-deploy/assets/static-site.yaml +54 -54
- package/skills/engineering/render-deploy/references/blueprint-spec.md +718 -718
- package/skills/engineering/render-deploy/references/codebase-analysis.md +49 -49
- package/skills/engineering/render-deploy/references/configuration-guide.md +603 -603
- package/skills/engineering/render-deploy/references/deployment-details.md +224 -224
- package/skills/engineering/render-deploy/references/direct-creation.md +113 -113
- package/skills/engineering/render-deploy/references/error-patterns.md +13 -13
- package/skills/engineering/render-deploy/references/post-deploy-checks.md +36 -36
- package/skills/engineering/render-deploy/references/runtimes.md +473 -473
- package/skills/engineering/render-deploy/references/service-types.md +450 -450
- package/skills/engineering/render-deploy/references/troubleshooting-basics.md +36 -36
- package/skills/engineering/repomix/SKILL.md +215 -215
- package/skills/engineering/repomix/references/configuration.md +211 -211
- package/skills/engineering/repomix/references/usage-patterns.md +232 -232
- package/skills/engineering/repomix/scripts/README.md +179 -179
- package/skills/engineering/repomix/scripts/repomix_batch.py +455 -455
- package/skills/engineering/repomix/scripts/repos.example.json +15 -15
- package/skills/engineering/repomix/scripts/requirements.txt +15 -15
- package/skills/engineering/repomix/scripts/tests/test_repomix_batch.py +531 -531
- package/skills/engineering/setup-matt-pocock-skills/SKILL.md +121 -121
- package/skills/engineering/setup-matt-pocock-skills/domain.md +51 -51
- package/skills/engineering/setup-matt-pocock-skills/issue-tracker-github.md +22 -22
- package/skills/engineering/setup-matt-pocock-skills/issue-tracker-gitlab.md +23 -23
- package/skills/engineering/setup-matt-pocock-skills/issue-tracker-local.md +19 -19
- package/skills/engineering/setup-matt-pocock-skills/triage-labels.md +15 -15
- package/skills/engineering/shopify/README.md +66 -66
- package/skills/engineering/shopify/SKILL.md +319 -319
- package/skills/engineering/shopify/references/app-development.md +470 -470
- package/skills/engineering/shopify/references/extensions.md +493 -493
- package/skills/engineering/shopify/references/themes.md +498 -498
- package/skills/engineering/shopify/scripts/requirements.txt +19 -19
- package/skills/engineering/shopify/scripts/shopify_init.py +423 -423
- package/skills/engineering/shopify/scripts/tests/test_shopify_init.py +385 -385
- package/skills/engineering/tdd/SKILL.md +109 -109
- package/skills/engineering/tdd/deep-modules.md +33 -33
- package/skills/engineering/tdd/interface-design.md +31 -31
- package/skills/engineering/tdd/mocking.md +59 -59
- package/skills/engineering/tdd/refactoring.md +10 -10
- package/skills/engineering/tdd/tests.md +61 -61
- package/skills/engineering/to-issues/SKILL.md +81 -81
- package/skills/engineering/to-prd/SKILL.md +74 -74
- package/skills/engineering/triage/AGENT-BRIEF.md +168 -168
- package/skills/engineering/triage/OUT-OF-SCOPE.md +101 -101
- package/skills/engineering/triage/SKILL.md +103 -103
- package/skills/engineering/web-frameworks/SKILL.md +324 -324
- package/skills/engineering/web-frameworks/references/nextjs-app-router.md +465 -465
- package/skills/engineering/web-frameworks/references/nextjs-data-fetching.md +459 -459
- package/skills/engineering/web-frameworks/references/nextjs-optimization.md +511 -511
- package/skills/engineering/web-frameworks/references/nextjs-server-components.md +495 -495
- package/skills/engineering/web-frameworks/references/remix-icon-integration.md +603 -603
- package/skills/engineering/web-frameworks/references/turborepo-caching.md +551 -551
- package/skills/engineering/web-frameworks/references/turborepo-pipelines.md +517 -517
- package/skills/engineering/web-frameworks/references/turborepo-setup.md +542 -542
- package/skills/engineering/web-frameworks/scripts/nextjs_init.py +547 -547
- package/skills/engineering/web-frameworks/scripts/requirements.txt +16 -16
- package/skills/engineering/web-frameworks/scripts/tests/requirements.txt +3 -3
- package/skills/engineering/web-frameworks/scripts/tests/test_nextjs_init.py +319 -319
- package/skills/engineering/web-frameworks/scripts/tests/test_turborepo_migrate.py +374 -374
- package/skills/engineering/web-frameworks/scripts/turborepo_migrate.py +394 -394
- package/skills/engineering/write-a-skill/SKILL.md +117 -117
- package/skills/kilo-kit/SKILL.md +346 -346
- package/skills/kilo-kit/_template/SKILL.md +185 -185
- package/skills/kilo-kit/debugging/root-cause/SKILL.md +360 -360
- package/skills/kilo-kit/debugging/systematic/SKILL.md +339 -339
- package/skills/kilo-kit/debugging/verification/SKILL.md +424 -424
- package/skills/kilo-kit/development/backend/SKILL.md +540 -540
- package/skills/kilo-kit/development/security/SKILL.md +529 -529
- package/skills/kilo-kit/quality/code-review/SKILL.md +297 -297
- package/skills/kilo-kit/quality/testing/SKILL.md +540 -540
- package/skills/kilo-kit/references/output-formats.md +204 -204
- package/skills/kilo-kit/references/patterns.md +156 -156
- package/skills/kilo-kit/references/performance-benchmarks.md +90 -90
- package/skills/operations/chrome-devtools/SKILL.md +392 -392
- package/skills/operations/chrome-devtools/references/cdp-domains.md +694 -694
- package/skills/operations/chrome-devtools/references/performance-guide.md +940 -940
- package/skills/operations/chrome-devtools/references/puppeteer-reference.md +953 -953
- package/skills/operations/chrome-devtools/scripts/PERSISTENT-BROWSER.md +107 -107
- package/skills/operations/chrome-devtools/scripts/README.md +213 -213
- package/skills/operations/chrome-devtools/scripts/__tests__/selector.test.js +210 -210
- package/skills/operations/chrome-devtools/scripts/click.js +79 -79
- package/skills/operations/chrome-devtools/scripts/close-persistent.js +36 -36
- package/skills/operations/chrome-devtools/scripts/console.js +75 -75
- package/skills/operations/chrome-devtools/scripts/evaluate.js +49 -49
- package/skills/operations/chrome-devtools/scripts/fill.js +72 -72
- package/skills/operations/chrome-devtools/scripts/install-deps.sh +181 -181
- package/skills/operations/chrome-devtools/scripts/install.sh +83 -83
- package/skills/operations/chrome-devtools/scripts/launch-persistent.js +71 -71
- package/skills/operations/chrome-devtools/scripts/lib/browser.js +144 -144
- package/skills/operations/chrome-devtools/scripts/lib/selector.js +178 -178
- package/skills/operations/chrome-devtools/scripts/navigate.js +46 -46
- package/skills/operations/chrome-devtools/scripts/network.js +102 -102
- package/skills/operations/chrome-devtools/scripts/package-lock.json +1206 -1206
- package/skills/operations/chrome-devtools/scripts/package.json +15 -15
- package/skills/operations/chrome-devtools/scripts/performance.js +145 -145
- package/skills/operations/chrome-devtools/scripts/screenshot.js +180 -180
- package/skills/operations/chrome-devtools/scripts/snapshot.js +131 -131
- package/skills/operations/devops/.env.example +76 -76
- package/skills/operations/devops/SKILL.md +285 -285
- package/skills/operations/devops/references/browser-rendering.md +305 -305
- package/skills/operations/devops/references/cloudflare-d1-kv.md +123 -123
- package/skills/operations/devops/references/cloudflare-platform.md +271 -271
- package/skills/operations/devops/references/cloudflare-r2-storage.md +280 -280
- package/skills/operations/devops/references/cloudflare-workers-advanced.md +312 -312
- package/skills/operations/devops/references/cloudflare-workers-apis.md +309 -309
- package/skills/operations/devops/references/cloudflare-workers-basics.md +418 -418
- package/skills/operations/devops/references/docker-basics.md +297 -297
- package/skills/operations/devops/references/docker-compose.md +292 -292
- package/skills/operations/devops/references/gcloud-platform.md +297 -297
- package/skills/operations/devops/references/gcloud-services.md +304 -304
- package/skills/operations/devops/scripts/cloudflare_deploy.py +269 -269
- package/skills/operations/devops/scripts/docker_optimize.py +320 -320
- package/skills/operations/devops/scripts/requirements.txt +20 -20
- package/skills/operations/devops/scripts/tests/requirements.txt +3 -3
- package/skills/operations/devops/scripts/tests/test_cloudflare_deploy.py +285 -285
- package/skills/operations/devops/scripts/tests/test_docker_optimize.py +436 -436
- package/skills/operations/mcp-builder/LICENSE.txt +201 -201
- package/skills/operations/mcp-builder/SKILL.md +328 -328
- package/skills/operations/mcp-builder/reference/evaluation.md +601 -601
- package/skills/operations/mcp-builder/reference/mcp_best_practices.md +915 -915
- package/skills/operations/mcp-builder/reference/node_mcp_server.md +915 -915
- package/skills/operations/mcp-builder/reference/python_mcp_server.md +751 -751
- package/skills/operations/mcp-builder/scripts/connections.py +151 -151
- package/skills/operations/mcp-builder/scripts/evaluation.py +373 -373
- package/skills/operations/mcp-builder/scripts/example_evaluation.xml +22 -22
- package/skills/operations/mcp-builder/scripts/requirements.txt +2 -2
- package/skills/operations/mcp-management/README.md +219 -219
- package/skills/operations/mcp-management/SKILL.md +175 -175
- package/skills/operations/mcp-management/assets/tools.json +3043 -3043
- package/skills/operations/mcp-management/references/configuration.md +114 -114
- package/skills/operations/mcp-management/references/gemini-cli-integration.md +201 -201
- package/skills/operations/mcp-management/references/mcp-protocol.md +116 -116
- package/skills/operations/mcp-management/scripts/.env.example +10 -10
- package/skills/operations/mcp-management/scripts/cli.ts +155 -155
- package/skills/operations/mcp-management/scripts/dist/analyze-tools.js +70 -70
- package/skills/operations/mcp-management/scripts/dist/cli.js +131 -131
- package/skills/operations/mcp-management/scripts/dist/mcp-client.js +115 -115
- package/skills/operations/mcp-management/scripts/mcp-client.ts +163 -163
- package/skills/operations/mcp-management/scripts/package.json +18 -18
- package/skills/operations/mcp-management/scripts/tsconfig.json +15 -15
- package/skills/problem-solving/collision-zone-thinking/SKILL.md +62 -62
- package/skills/problem-solving/defense-in-depth/SKILL.md +130 -130
- package/skills/problem-solving/inversion-exercise/SKILL.md +58 -58
- package/skills/problem-solving/meta-pattern-recognition/SKILL.md +54 -54
- package/skills/problem-solving/root-cause-tracing/SKILL.md +177 -177
- package/skills/problem-solving/root-cause-tracing/find-polluter.sh +63 -63
- package/skills/problem-solving/scale-game/SKILL.md +63 -63
- package/skills/problem-solving/sequential-thinking/README.md +118 -118
- package/skills/problem-solving/sequential-thinking/SKILL.md +93 -93
- package/skills/problem-solving/sequential-thinking/references/advanced.md +122 -122
- package/skills/problem-solving/sequential-thinking/references/examples.md +274 -274
- package/skills/problem-solving/simplification-cascades/SKILL.md +76 -76
- package/skills/problem-solving/when-stuck/SKILL.md +88 -88
- package/skills/productivity/caveman/SKILL.md +49 -49
- package/skills/productivity/grill-me/SKILL.md +10 -10
- package/skills/productivity/grill-with-docs/ADR-FORMAT.md +47 -47
- package/skills/productivity/grill-with-docs/CONTEXT-FORMAT.md +77 -77
- package/skills/productivity/grill-with-docs/SKILL.md +88 -88
- package/skills/productivity/writing-skills/graphviz-conventions.dot +171 -171
- package/skills/productivity/zoom-out/SKILL.md +7 -7
- package/skills/writing-docs/doc/LICENSE.txt +201 -201
- package/skills/writing-docs/doc/SKILL.md +80 -80
- package/skills/writing-docs/doc/agents/openai.yaml +6 -6
- package/skills/writing-docs/doc/assets/doc-small.svg +3 -3
- package/skills/writing-docs/doc/scripts/render_docx.py +296 -296
- package/skills/writing-docs/docx/LICENSE.txt +30 -30
- package/skills/writing-docs/docx/SKILL.md +196 -196
- package/skills/writing-docs/docx/docx-js.md +349 -349
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -1499
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -146
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -1085
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -11
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -3081
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -23
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -185
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -287
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -1676
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -28
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -144
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -174
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -25
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -18
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -59
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -56
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -195
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -582
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -25
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -4439
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -570
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -509
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -12
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -108
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -96
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -3646
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -116
- package/skills/writing-docs/docx/ooxml/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -42
- package/skills/writing-docs/docx/ooxml/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -50
- package/skills/writing-docs/docx/ooxml/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -49
- package/skills/writing-docs/docx/ooxml/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -33
- package/skills/writing-docs/docx/ooxml/schemas/mce/mc.xsd +75 -75
- package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-2010.xsd +560 -560
- package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-2012.xsd +67 -67
- package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-2018.xsd +14 -14
- package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-cex-2018.xsd +20 -20
- package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-cid-2016.xsd +13 -13
- package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -4
- package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-symex-2015.xsd +8 -8
- package/skills/writing-docs/docx/ooxml/scripts/pack.py +159 -159
- package/skills/writing-docs/docx/ooxml/scripts/unpack.py +29 -29
- package/skills/writing-docs/docx/ooxml/scripts/validate.py +69 -69
- package/skills/writing-docs/docx/ooxml/scripts/validation/__init__.py +15 -15
- package/skills/writing-docs/docx/ooxml/scripts/validation/base.py +951 -951
- package/skills/writing-docs/docx/ooxml/scripts/validation/docx.py +274 -274
- package/skills/writing-docs/docx/ooxml/scripts/validation/pptx.py +315 -315
- package/skills/writing-docs/docx/ooxml/scripts/validation/redlining.py +279 -279
- package/skills/writing-docs/docx/ooxml.md +609 -609
- package/skills/writing-docs/docx/scripts/__init__.py +1 -1
- package/skills/writing-docs/docx/scripts/document.py +1276 -1276
- package/skills/writing-docs/docx/scripts/templates/comments.xml +2 -2
- package/skills/writing-docs/docx/scripts/templates/commentsExtended.xml +2 -2
- package/skills/writing-docs/docx/scripts/templates/commentsExtensible.xml +2 -2
- package/skills/writing-docs/docx/scripts/templates/commentsIds.xml +2 -2
- package/skills/writing-docs/docx/scripts/templates/people.xml +2 -2
- package/skills/writing-docs/docx/scripts/utilities.py +374 -374
- package/skills/writing-docs/mermaidjs-v11/SKILL.md +115 -115
- package/skills/writing-docs/mermaidjs-v11/references/cli-usage.md +228 -228
- package/skills/writing-docs/mermaidjs-v11/references/configuration.md +232 -232
- package/skills/writing-docs/mermaidjs-v11/references/diagram-types.md +315 -315
- package/skills/writing-docs/mermaidjs-v11/references/examples.md +344 -344
- package/skills/writing-docs/mermaidjs-v11/references/integration.md +310 -310
- package/skills/writing-docs/pdf/LICENSE.txt +30 -30
- package/skills/writing-docs/pdf/SKILL.md +294 -294
- package/skills/writing-docs/pdf/forms.md +205 -205
- package/skills/writing-docs/pdf/reference.md +611 -611
- package/skills/writing-docs/pdf/scripts/check_bounding_boxes.py +70 -70
- package/skills/writing-docs/pdf/scripts/check_bounding_boxes_test.py +226 -226
- package/skills/writing-docs/pdf/scripts/check_fillable_fields.py +12 -12
- package/skills/writing-docs/pdf/scripts/convert_pdf_to_images.py +35 -35
- package/skills/writing-docs/pdf/scripts/create_validation_image.py +41 -41
- package/skills/writing-docs/pdf/scripts/extract_form_field_info.py +152 -152
- package/skills/writing-docs/pdf/scripts/fill_fillable_fields.py +114 -114
- package/skills/writing-docs/pdf/scripts/fill_pdf_form_with_annotations.py +107 -107
- package/skills/writing-docs/pptx/LICENSE.txt +30 -30
- package/skills/writing-docs/pptx/SKILL.md +483 -483
- package/skills/writing-docs/pptx/html2pptx.md +624 -624
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -1499
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -146
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -1085
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -11
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -3081
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -23
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -185
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -287
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -1676
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -28
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -144
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -174
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -25
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -18
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -59
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -56
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -195
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -582
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -25
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -4439
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -570
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -509
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -12
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -108
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -96
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -3646
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -116
- package/skills/writing-docs/pptx/ooxml/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -42
- package/skills/writing-docs/pptx/ooxml/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -50
- package/skills/writing-docs/pptx/ooxml/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -49
- package/skills/writing-docs/pptx/ooxml/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -33
- package/skills/writing-docs/pptx/ooxml/schemas/mce/mc.xsd +75 -75
- package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-2010.xsd +560 -560
- package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-2012.xsd +67 -67
- package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-2018.xsd +14 -14
- package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-cex-2018.xsd +20 -20
- package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-cid-2016.xsd +13 -13
- package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -4
- package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-symex-2015.xsd +8 -8
- package/skills/writing-docs/pptx/ooxml/scripts/pack.py +159 -159
- package/skills/writing-docs/pptx/ooxml/scripts/unpack.py +29 -29
- package/skills/writing-docs/pptx/ooxml/scripts/validate.py +69 -69
- package/skills/writing-docs/pptx/ooxml/scripts/validation/__init__.py +15 -15
- package/skills/writing-docs/pptx/ooxml/scripts/validation/base.py +951 -951
- package/skills/writing-docs/pptx/ooxml/scripts/validation/docx.py +274 -274
- package/skills/writing-docs/pptx/ooxml/scripts/validation/pptx.py +315 -315
- package/skills/writing-docs/pptx/ooxml/scripts/validation/redlining.py +279 -279
- package/skills/writing-docs/pptx/ooxml.md +426 -426
- package/skills/writing-docs/pptx/scripts/html2pptx.js +978 -978
- package/skills/writing-docs/pptx/scripts/inventory.py +1020 -1020
- package/skills/writing-docs/pptx/scripts/rearrange.py +231 -231
- package/skills/writing-docs/pptx/scripts/replace.py +385 -385
- package/skills/writing-docs/pptx/scripts/thumbnail.py +450 -450
- package/skills/writing-docs/slides/LICENSE.txt +201 -201
- package/skills/writing-docs/slides/SKILL.md +71 -71
- package/skills/writing-docs/slides/agents/openai.yaml +6 -6
- package/skills/writing-docs/slides/assets/pptxgenjs_helpers/code.js +104 -104
- package/skills/writing-docs/slides/assets/pptxgenjs_helpers/image.js +333 -333
- package/skills/writing-docs/slides/assets/pptxgenjs_helpers/index.js +33 -33
- package/skills/writing-docs/slides/assets/pptxgenjs_helpers/latex.js +51 -51
- package/skills/writing-docs/slides/assets/pptxgenjs_helpers/layout.js +643 -643
- package/skills/writing-docs/slides/assets/pptxgenjs_helpers/layout_builders.js +358 -358
- package/skills/writing-docs/slides/assets/pptxgenjs_helpers/svg.js +36 -36
- package/skills/writing-docs/slides/assets/pptxgenjs_helpers/text.js +789 -789
- package/skills/writing-docs/slides/assets/pptxgenjs_helpers/util.js +24 -24
- package/skills/writing-docs/slides/assets/slides-small.svg +3 -3
- package/skills/writing-docs/slides/references/pptxgenjs-helpers.md +61 -61
- package/skills/writing-docs/slides/scripts/create_montage.py +300 -300
- package/skills/writing-docs/slides/scripts/detect_font.py +873 -873
- package/skills/writing-docs/slides/scripts/ensure_raster_image.py +202 -202
- package/skills/writing-docs/slides/scripts/render_slides.py +273 -273
- package/skills/writing-docs/slides/scripts/slides_test.py +201 -201
- package/skills/writing-docs/template-skill/SKILL.md +26 -26
- package/skills/writing-docs/xlsx/LICENSE.txt +30 -30
- package/skills/writing-docs/xlsx/SKILL.md +288 -288
- package/skills/writing-docs/xlsx/recalc.py +177 -177
- package/src/core/KILO_MASTER.md +448 -448
- package/src/tools/validate-skill.js +421 -421
|
@@ -1,414 +1,414 @@
|
|
|
1
|
-
#!/usr/bin/env python3
|
|
2
|
-
"""
|
|
3
|
-
Video size optimization with quality/size balance.
|
|
4
|
-
|
|
5
|
-
Supports resolution reduction, frame rate adjustment, audio bitrate optimization,
|
|
6
|
-
multi-pass encoding, and comparison metrics.
|
|
7
|
-
"""
|
|
8
|
-
|
|
9
|
-
import argparse
|
|
10
|
-
import json
|
|
11
|
-
import subprocess
|
|
12
|
-
import sys
|
|
13
|
-
from dataclasses import dataclass
|
|
14
|
-
from pathlib import Path
|
|
15
|
-
from typing import Optional, Tuple
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
@dataclass
|
|
19
|
-
class VideoInfo:
|
|
20
|
-
"""Video file information."""
|
|
21
|
-
path: Path
|
|
22
|
-
duration: float
|
|
23
|
-
width: int
|
|
24
|
-
height: int
|
|
25
|
-
bitrate: int
|
|
26
|
-
fps: float
|
|
27
|
-
size: int
|
|
28
|
-
codec: str
|
|
29
|
-
audio_codec: str
|
|
30
|
-
audio_bitrate: int
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
class VideoOptimizer:
|
|
34
|
-
"""Handle video optimization operations using FFmpeg."""
|
|
35
|
-
|
|
36
|
-
def __init__(self, verbose: bool = False, dry_run: bool = False):
|
|
37
|
-
self.verbose = verbose
|
|
38
|
-
self.dry_run = dry_run
|
|
39
|
-
|
|
40
|
-
def check_ffmpeg(self) -> bool:
|
|
41
|
-
"""Check if FFmpeg is available."""
|
|
42
|
-
try:
|
|
43
|
-
subprocess.run(
|
|
44
|
-
['ffmpeg', '-version'],
|
|
45
|
-
stdout=subprocess.DEVNULL,
|
|
46
|
-
stderr=subprocess.DEVNULL,
|
|
47
|
-
check=True
|
|
48
|
-
)
|
|
49
|
-
return True
|
|
50
|
-
except (subprocess.CalledProcessError, FileNotFoundError):
|
|
51
|
-
return False
|
|
52
|
-
|
|
53
|
-
def get_video_info(self, input_path: Path) -> Optional[VideoInfo]:
|
|
54
|
-
"""Extract video information using ffprobe."""
|
|
55
|
-
try:
|
|
56
|
-
cmd = [
|
|
57
|
-
'ffprobe',
|
|
58
|
-
'-v', 'quiet',
|
|
59
|
-
'-print_format', 'json',
|
|
60
|
-
'-show_format',
|
|
61
|
-
'-show_streams',
|
|
62
|
-
str(input_path)
|
|
63
|
-
]
|
|
64
|
-
|
|
65
|
-
result = subprocess.run(cmd, capture_output=True, check=True)
|
|
66
|
-
data = json.loads(result.stdout)
|
|
67
|
-
|
|
68
|
-
# Find video and audio streams
|
|
69
|
-
video_stream = None
|
|
70
|
-
audio_stream = None
|
|
71
|
-
|
|
72
|
-
for stream in data['streams']:
|
|
73
|
-
if stream['codec_type'] == 'video' and not video_stream:
|
|
74
|
-
video_stream = stream
|
|
75
|
-
elif stream['codec_type'] == 'audio' and not audio_stream:
|
|
76
|
-
audio_stream = stream
|
|
77
|
-
|
|
78
|
-
if not video_stream:
|
|
79
|
-
return None
|
|
80
|
-
|
|
81
|
-
# Parse frame rate
|
|
82
|
-
fps_parts = video_stream.get('r_frame_rate', '0/1').split('/')
|
|
83
|
-
fps = float(fps_parts[0]) / float(fps_parts[1]) if len(fps_parts) == 2 else 0
|
|
84
|
-
|
|
85
|
-
return VideoInfo(
|
|
86
|
-
path=input_path,
|
|
87
|
-
duration=float(data['format'].get('duration', 0)),
|
|
88
|
-
width=int(video_stream.get('width', 0)),
|
|
89
|
-
height=int(video_stream.get('height', 0)),
|
|
90
|
-
bitrate=int(data['format'].get('bit_rate', 0)),
|
|
91
|
-
fps=fps,
|
|
92
|
-
size=int(data['format'].get('size', 0)),
|
|
93
|
-
codec=video_stream.get('codec_name', 'unknown'),
|
|
94
|
-
audio_codec=audio_stream.get('codec_name', 'none') if audio_stream else 'none',
|
|
95
|
-
audio_bitrate=int(audio_stream.get('bit_rate', 0)) if audio_stream else 0
|
|
96
|
-
)
|
|
97
|
-
|
|
98
|
-
except Exception as e:
|
|
99
|
-
print(f"Error getting video info: {e}", file=sys.stderr)
|
|
100
|
-
return None
|
|
101
|
-
|
|
102
|
-
def calculate_target_resolution(
|
|
103
|
-
self,
|
|
104
|
-
width: int,
|
|
105
|
-
height: int,
|
|
106
|
-
max_width: Optional[int],
|
|
107
|
-
max_height: Optional[int]
|
|
108
|
-
) -> Tuple[int, int]:
|
|
109
|
-
"""Calculate target resolution maintaining aspect ratio."""
|
|
110
|
-
if not max_width and not max_height:
|
|
111
|
-
return width, height
|
|
112
|
-
|
|
113
|
-
aspect_ratio = width / height
|
|
114
|
-
|
|
115
|
-
if max_width and max_height:
|
|
116
|
-
# Fit within both constraints
|
|
117
|
-
if width > max_width or height > max_height:
|
|
118
|
-
if width / max_width > height / max_height:
|
|
119
|
-
new_width = max_width
|
|
120
|
-
new_height = int(max_width / aspect_ratio)
|
|
121
|
-
else:
|
|
122
|
-
new_height = max_height
|
|
123
|
-
new_width = int(max_height * aspect_ratio)
|
|
124
|
-
else:
|
|
125
|
-
new_width, new_height = width, height
|
|
126
|
-
elif max_width:
|
|
127
|
-
new_width = min(width, max_width)
|
|
128
|
-
new_height = int(new_width / aspect_ratio)
|
|
129
|
-
else:
|
|
130
|
-
new_height = min(height, max_height)
|
|
131
|
-
new_width = int(new_height * aspect_ratio)
|
|
132
|
-
|
|
133
|
-
# Ensure dimensions are even (required by some codecs)
|
|
134
|
-
new_width = new_width - (new_width % 2)
|
|
135
|
-
new_height = new_height - (new_height % 2)
|
|
136
|
-
|
|
137
|
-
return new_width, new_height
|
|
138
|
-
|
|
139
|
-
def optimize_video(
|
|
140
|
-
self,
|
|
141
|
-
input_path: Path,
|
|
142
|
-
output_path: Path,
|
|
143
|
-
max_width: Optional[int] = None,
|
|
144
|
-
max_height: Optional[int] = None,
|
|
145
|
-
target_fps: Optional[float] = None,
|
|
146
|
-
crf: int = 23,
|
|
147
|
-
audio_bitrate: str = '128k',
|
|
148
|
-
preset: str = 'medium',
|
|
149
|
-
two_pass: bool = False
|
|
150
|
-
) -> bool:
|
|
151
|
-
"""Optimize a video file."""
|
|
152
|
-
# Get input video info
|
|
153
|
-
info = self.get_video_info(input_path)
|
|
154
|
-
if not info:
|
|
155
|
-
print(f"Error: Could not read video info for {input_path}", file=sys.stderr)
|
|
156
|
-
return False
|
|
157
|
-
|
|
158
|
-
if self.verbose:
|
|
159
|
-
print(f"\nInput video info:")
|
|
160
|
-
print(f" Resolution: {info.width}x{info.height}")
|
|
161
|
-
print(f" FPS: {info.fps:.2f}")
|
|
162
|
-
print(f" Bitrate: {info.bitrate // 1000} kbps")
|
|
163
|
-
print(f" Size: {info.size / (1024*1024):.2f} MB")
|
|
164
|
-
|
|
165
|
-
# Calculate target resolution
|
|
166
|
-
target_width, target_height = self.calculate_target_resolution(
|
|
167
|
-
info.width, info.height, max_width, max_height
|
|
168
|
-
)
|
|
169
|
-
|
|
170
|
-
# Build FFmpeg command
|
|
171
|
-
cmd = ['ffmpeg', '-i', str(input_path)]
|
|
172
|
-
|
|
173
|
-
# Video filters
|
|
174
|
-
filters = []
|
|
175
|
-
if target_width != info.width or target_height != info.height:
|
|
176
|
-
filters.append(f'scale={target_width}:{target_height}')
|
|
177
|
-
|
|
178
|
-
if filters:
|
|
179
|
-
cmd.extend(['-vf', ','.join(filters)])
|
|
180
|
-
|
|
181
|
-
# Frame rate adjustment
|
|
182
|
-
if target_fps and target_fps < info.fps:
|
|
183
|
-
cmd.extend(['-r', str(target_fps)])
|
|
184
|
-
|
|
185
|
-
# Video encoding
|
|
186
|
-
if two_pass:
|
|
187
|
-
# Two-pass encoding for better quality
|
|
188
|
-
target_bitrate = int(info.bitrate * 0.7) # 30% reduction
|
|
189
|
-
|
|
190
|
-
# Pass 1
|
|
191
|
-
pass1_cmd = cmd + [
|
|
192
|
-
'-c:v', 'libx264',
|
|
193
|
-
'-preset', preset,
|
|
194
|
-
'-b:v', str(target_bitrate),
|
|
195
|
-
'-pass', '1',
|
|
196
|
-
'-an',
|
|
197
|
-
'-f', 'null',
|
|
198
|
-
'/dev/null' if sys.platform != 'win32' else 'NUL'
|
|
199
|
-
]
|
|
200
|
-
|
|
201
|
-
if self.verbose or self.dry_run:
|
|
202
|
-
print(f"Pass 1: {' '.join(pass1_cmd)}")
|
|
203
|
-
|
|
204
|
-
if not self.dry_run:
|
|
205
|
-
try:
|
|
206
|
-
subprocess.run(pass1_cmd, check=True, capture_output=not self.verbose)
|
|
207
|
-
except subprocess.CalledProcessError as e:
|
|
208
|
-
print(f"Error in pass 1: {e}", file=sys.stderr)
|
|
209
|
-
return False
|
|
210
|
-
|
|
211
|
-
# Pass 2
|
|
212
|
-
cmd.extend([
|
|
213
|
-
'-c:v', 'libx264',
|
|
214
|
-
'-preset', preset,
|
|
215
|
-
'-b:v', str(target_bitrate),
|
|
216
|
-
'-pass', '2'
|
|
217
|
-
])
|
|
218
|
-
else:
|
|
219
|
-
# Single-pass CRF encoding
|
|
220
|
-
cmd.extend([
|
|
221
|
-
'-c:v', 'libx264',
|
|
222
|
-
'-preset', preset,
|
|
223
|
-
'-crf', str(crf)
|
|
224
|
-
])
|
|
225
|
-
|
|
226
|
-
# Audio encoding
|
|
227
|
-
cmd.extend([
|
|
228
|
-
'-c:a', 'aac',
|
|
229
|
-
'-b:a', audio_bitrate
|
|
230
|
-
])
|
|
231
|
-
|
|
232
|
-
# Output
|
|
233
|
-
cmd.extend(['-movflags', '+faststart', '-y', str(output_path)])
|
|
234
|
-
|
|
235
|
-
if self.verbose or self.dry_run:
|
|
236
|
-
print(f"Command: {' '.join(cmd)}")
|
|
237
|
-
|
|
238
|
-
if self.dry_run:
|
|
239
|
-
return True
|
|
240
|
-
|
|
241
|
-
# Execute
|
|
242
|
-
try:
|
|
243
|
-
subprocess.run(cmd, check=True, capture_output=not self.verbose)
|
|
244
|
-
|
|
245
|
-
# Get output info
|
|
246
|
-
output_info = self.get_video_info(output_path)
|
|
247
|
-
if output_info and self.verbose:
|
|
248
|
-
print(f"\nOutput video info:")
|
|
249
|
-
print(f" Resolution: {output_info.width}x{output_info.height}")
|
|
250
|
-
print(f" FPS: {output_info.fps:.2f}")
|
|
251
|
-
print(f" Bitrate: {output_info.bitrate // 1000} kbps")
|
|
252
|
-
print(f" Size: {output_info.size / (1024*1024):.2f} MB")
|
|
253
|
-
reduction = (1 - output_info.size / info.size) * 100
|
|
254
|
-
print(f" Size reduction: {reduction:.1f}%")
|
|
255
|
-
|
|
256
|
-
return True
|
|
257
|
-
|
|
258
|
-
except subprocess.CalledProcessError as e:
|
|
259
|
-
print(f"Error optimizing video: {e}", file=sys.stderr)
|
|
260
|
-
return False
|
|
261
|
-
except Exception as e:
|
|
262
|
-
print(f"Error optimizing video: {e}", file=sys.stderr)
|
|
263
|
-
return False
|
|
264
|
-
finally:
|
|
265
|
-
# Clean up two-pass log files
|
|
266
|
-
if two_pass and not self.dry_run:
|
|
267
|
-
for log_file in Path('.').glob('ffmpeg2pass-*.log*'):
|
|
268
|
-
log_file.unlink(missing_ok=True)
|
|
269
|
-
|
|
270
|
-
def compare_videos(self, original: Path, optimized: Path) -> None:
|
|
271
|
-
"""Compare original and optimized videos."""
|
|
272
|
-
orig_info = self.get_video_info(original)
|
|
273
|
-
opt_info = self.get_video_info(optimized)
|
|
274
|
-
|
|
275
|
-
if not orig_info or not opt_info:
|
|
276
|
-
print("Error: Could not compare videos", file=sys.stderr)
|
|
277
|
-
return
|
|
278
|
-
|
|
279
|
-
print(f"\n{'Metric':<20} {'Original':<20} {'Optimized':<20} {'Change':<15}")
|
|
280
|
-
print("-" * 75)
|
|
281
|
-
|
|
282
|
-
# Resolution
|
|
283
|
-
orig_res = f"{orig_info.width}x{orig_info.height}"
|
|
284
|
-
opt_res = f"{opt_info.width}x{opt_info.height}"
|
|
285
|
-
print(f"{'Resolution':<20} {orig_res:<20} {opt_res:<20}")
|
|
286
|
-
|
|
287
|
-
# FPS
|
|
288
|
-
fps_change = opt_info.fps - orig_info.fps
|
|
289
|
-
print(f"{'FPS':<20} {orig_info.fps:<20.2f} {opt_info.fps:<20.2f} {fps_change:+.2f}")
|
|
290
|
-
|
|
291
|
-
# Bitrate
|
|
292
|
-
orig_br = f"{orig_info.bitrate // 1000} kbps"
|
|
293
|
-
opt_br = f"{opt_info.bitrate // 1000} kbps"
|
|
294
|
-
br_change = ((opt_info.bitrate / orig_info.bitrate) - 1) * 100
|
|
295
|
-
print(f"{'Bitrate':<20} {orig_br:<20} {opt_br:<20} {br_change:+.1f}%")
|
|
296
|
-
|
|
297
|
-
# Size
|
|
298
|
-
orig_size = f"{orig_info.size / (1024*1024):.2f} MB"
|
|
299
|
-
opt_size = f"{opt_info.size / (1024*1024):.2f} MB"
|
|
300
|
-
size_reduction = (1 - opt_info.size / orig_info.size) * 100
|
|
301
|
-
print(f"{'Size':<20} {orig_size:<20} {opt_size:<20} {-size_reduction:.1f}%")
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
def main():
|
|
305
|
-
"""Main entry point."""
|
|
306
|
-
parser = argparse.ArgumentParser(
|
|
307
|
-
description='Video size optimization with quality/size balance.'
|
|
308
|
-
)
|
|
309
|
-
parser.add_argument(
|
|
310
|
-
'input',
|
|
311
|
-
type=Path,
|
|
312
|
-
help='Input video file'
|
|
313
|
-
)
|
|
314
|
-
parser.add_argument(
|
|
315
|
-
'-o', '--output',
|
|
316
|
-
type=Path,
|
|
317
|
-
required=True,
|
|
318
|
-
help='Output video file'
|
|
319
|
-
)
|
|
320
|
-
parser.add_argument(
|
|
321
|
-
'-w', '--max-width',
|
|
322
|
-
type=int,
|
|
323
|
-
help='Maximum width in pixels'
|
|
324
|
-
)
|
|
325
|
-
parser.add_argument(
|
|
326
|
-
'-H', '--max-height',
|
|
327
|
-
type=int,
|
|
328
|
-
help='Maximum height in pixels'
|
|
329
|
-
)
|
|
330
|
-
parser.add_argument(
|
|
331
|
-
'--fps',
|
|
332
|
-
type=float,
|
|
333
|
-
help='Target frame rate'
|
|
334
|
-
)
|
|
335
|
-
parser.add_argument(
|
|
336
|
-
'--crf',
|
|
337
|
-
type=int,
|
|
338
|
-
default=23,
|
|
339
|
-
help='CRF quality (18-28, lower=better, default: 23)'
|
|
340
|
-
)
|
|
341
|
-
parser.add_argument(
|
|
342
|
-
'--audio-bitrate',
|
|
343
|
-
default='128k',
|
|
344
|
-
help='Audio bitrate (default: 128k)'
|
|
345
|
-
)
|
|
346
|
-
parser.add_argument(
|
|
347
|
-
'--preset',
|
|
348
|
-
choices=['ultrafast', 'superfast', 'veryfast', 'faster', 'fast',
|
|
349
|
-
'medium', 'slow', 'slower', 'veryslow'],
|
|
350
|
-
default='medium',
|
|
351
|
-
help='Encoding preset (default: medium)'
|
|
352
|
-
)
|
|
353
|
-
parser.add_argument(
|
|
354
|
-
'--two-pass',
|
|
355
|
-
action='store_true',
|
|
356
|
-
help='Use two-pass encoding (better quality)'
|
|
357
|
-
)
|
|
358
|
-
parser.add_argument(
|
|
359
|
-
'--compare',
|
|
360
|
-
action='store_true',
|
|
361
|
-
help='Compare original and optimized videos'
|
|
362
|
-
)
|
|
363
|
-
parser.add_argument(
|
|
364
|
-
'-n', '--dry-run',
|
|
365
|
-
action='store_true',
|
|
366
|
-
help='Show command without executing'
|
|
367
|
-
)
|
|
368
|
-
parser.add_argument(
|
|
369
|
-
'-v', '--verbose',
|
|
370
|
-
action='store_true',
|
|
371
|
-
help='Verbose output'
|
|
372
|
-
)
|
|
373
|
-
|
|
374
|
-
args = parser.parse_args()
|
|
375
|
-
|
|
376
|
-
# Validate input
|
|
377
|
-
if not args.input.exists():
|
|
378
|
-
print(f"Error: Input file not found: {args.input}", file=sys.stderr)
|
|
379
|
-
sys.exit(1)
|
|
380
|
-
|
|
381
|
-
# Initialize optimizer
|
|
382
|
-
optimizer = VideoOptimizer(verbose=args.verbose, dry_run=args.dry_run)
|
|
383
|
-
|
|
384
|
-
# Check dependencies
|
|
385
|
-
if not optimizer.check_ffmpeg():
|
|
386
|
-
print("Error: FFmpeg not found", file=sys.stderr)
|
|
387
|
-
sys.exit(1)
|
|
388
|
-
|
|
389
|
-
# Optimize video
|
|
390
|
-
print(f"Optimizing {args.input.name}...")
|
|
391
|
-
success = optimizer.optimize_video(
|
|
392
|
-
args.input,
|
|
393
|
-
args.output,
|
|
394
|
-
args.max_width,
|
|
395
|
-
args.max_height,
|
|
396
|
-
args.fps,
|
|
397
|
-
args.crf,
|
|
398
|
-
args.audio_bitrate,
|
|
399
|
-
args.preset,
|
|
400
|
-
args.two_pass
|
|
401
|
-
)
|
|
402
|
-
|
|
403
|
-
if not success:
|
|
404
|
-
sys.exit(1)
|
|
405
|
-
|
|
406
|
-
# Compare if requested
|
|
407
|
-
if args.compare and not args.dry_run:
|
|
408
|
-
optimizer.compare_videos(args.input, args.output)
|
|
409
|
-
|
|
410
|
-
print(f"\nOptimized video saved to: {args.output}")
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
if __name__ == '__main__':
|
|
414
|
-
main()
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
Video size optimization with quality/size balance.
|
|
4
|
+
|
|
5
|
+
Supports resolution reduction, frame rate adjustment, audio bitrate optimization,
|
|
6
|
+
multi-pass encoding, and comparison metrics.
|
|
7
|
+
"""
|
|
8
|
+
|
|
9
|
+
import argparse
|
|
10
|
+
import json
|
|
11
|
+
import subprocess
|
|
12
|
+
import sys
|
|
13
|
+
from dataclasses import dataclass
|
|
14
|
+
from pathlib import Path
|
|
15
|
+
from typing import Optional, Tuple
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
@dataclass
|
|
19
|
+
class VideoInfo:
|
|
20
|
+
"""Video file information."""
|
|
21
|
+
path: Path
|
|
22
|
+
duration: float
|
|
23
|
+
width: int
|
|
24
|
+
height: int
|
|
25
|
+
bitrate: int
|
|
26
|
+
fps: float
|
|
27
|
+
size: int
|
|
28
|
+
codec: str
|
|
29
|
+
audio_codec: str
|
|
30
|
+
audio_bitrate: int
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
class VideoOptimizer:
|
|
34
|
+
"""Handle video optimization operations using FFmpeg."""
|
|
35
|
+
|
|
36
|
+
def __init__(self, verbose: bool = False, dry_run: bool = False):
|
|
37
|
+
self.verbose = verbose
|
|
38
|
+
self.dry_run = dry_run
|
|
39
|
+
|
|
40
|
+
def check_ffmpeg(self) -> bool:
|
|
41
|
+
"""Check if FFmpeg is available."""
|
|
42
|
+
try:
|
|
43
|
+
subprocess.run(
|
|
44
|
+
['ffmpeg', '-version'],
|
|
45
|
+
stdout=subprocess.DEVNULL,
|
|
46
|
+
stderr=subprocess.DEVNULL,
|
|
47
|
+
check=True
|
|
48
|
+
)
|
|
49
|
+
return True
|
|
50
|
+
except (subprocess.CalledProcessError, FileNotFoundError):
|
|
51
|
+
return False
|
|
52
|
+
|
|
53
|
+
def get_video_info(self, input_path: Path) -> Optional[VideoInfo]:
|
|
54
|
+
"""Extract video information using ffprobe."""
|
|
55
|
+
try:
|
|
56
|
+
cmd = [
|
|
57
|
+
'ffprobe',
|
|
58
|
+
'-v', 'quiet',
|
|
59
|
+
'-print_format', 'json',
|
|
60
|
+
'-show_format',
|
|
61
|
+
'-show_streams',
|
|
62
|
+
str(input_path)
|
|
63
|
+
]
|
|
64
|
+
|
|
65
|
+
result = subprocess.run(cmd, capture_output=True, check=True)
|
|
66
|
+
data = json.loads(result.stdout)
|
|
67
|
+
|
|
68
|
+
# Find video and audio streams
|
|
69
|
+
video_stream = None
|
|
70
|
+
audio_stream = None
|
|
71
|
+
|
|
72
|
+
for stream in data['streams']:
|
|
73
|
+
if stream['codec_type'] == 'video' and not video_stream:
|
|
74
|
+
video_stream = stream
|
|
75
|
+
elif stream['codec_type'] == 'audio' and not audio_stream:
|
|
76
|
+
audio_stream = stream
|
|
77
|
+
|
|
78
|
+
if not video_stream:
|
|
79
|
+
return None
|
|
80
|
+
|
|
81
|
+
# Parse frame rate
|
|
82
|
+
fps_parts = video_stream.get('r_frame_rate', '0/1').split('/')
|
|
83
|
+
fps = float(fps_parts[0]) / float(fps_parts[1]) if len(fps_parts) == 2 else 0
|
|
84
|
+
|
|
85
|
+
return VideoInfo(
|
|
86
|
+
path=input_path,
|
|
87
|
+
duration=float(data['format'].get('duration', 0)),
|
|
88
|
+
width=int(video_stream.get('width', 0)),
|
|
89
|
+
height=int(video_stream.get('height', 0)),
|
|
90
|
+
bitrate=int(data['format'].get('bit_rate', 0)),
|
|
91
|
+
fps=fps,
|
|
92
|
+
size=int(data['format'].get('size', 0)),
|
|
93
|
+
codec=video_stream.get('codec_name', 'unknown'),
|
|
94
|
+
audio_codec=audio_stream.get('codec_name', 'none') if audio_stream else 'none',
|
|
95
|
+
audio_bitrate=int(audio_stream.get('bit_rate', 0)) if audio_stream else 0
|
|
96
|
+
)
|
|
97
|
+
|
|
98
|
+
except Exception as e:
|
|
99
|
+
print(f"Error getting video info: {e}", file=sys.stderr)
|
|
100
|
+
return None
|
|
101
|
+
|
|
102
|
+
def calculate_target_resolution(
|
|
103
|
+
self,
|
|
104
|
+
width: int,
|
|
105
|
+
height: int,
|
|
106
|
+
max_width: Optional[int],
|
|
107
|
+
max_height: Optional[int]
|
|
108
|
+
) -> Tuple[int, int]:
|
|
109
|
+
"""Calculate target resolution maintaining aspect ratio."""
|
|
110
|
+
if not max_width and not max_height:
|
|
111
|
+
return width, height
|
|
112
|
+
|
|
113
|
+
aspect_ratio = width / height
|
|
114
|
+
|
|
115
|
+
if max_width and max_height:
|
|
116
|
+
# Fit within both constraints
|
|
117
|
+
if width > max_width or height > max_height:
|
|
118
|
+
if width / max_width > height / max_height:
|
|
119
|
+
new_width = max_width
|
|
120
|
+
new_height = int(max_width / aspect_ratio)
|
|
121
|
+
else:
|
|
122
|
+
new_height = max_height
|
|
123
|
+
new_width = int(max_height * aspect_ratio)
|
|
124
|
+
else:
|
|
125
|
+
new_width, new_height = width, height
|
|
126
|
+
elif max_width:
|
|
127
|
+
new_width = min(width, max_width)
|
|
128
|
+
new_height = int(new_width / aspect_ratio)
|
|
129
|
+
else:
|
|
130
|
+
new_height = min(height, max_height)
|
|
131
|
+
new_width = int(new_height * aspect_ratio)
|
|
132
|
+
|
|
133
|
+
# Ensure dimensions are even (required by some codecs)
|
|
134
|
+
new_width = new_width - (new_width % 2)
|
|
135
|
+
new_height = new_height - (new_height % 2)
|
|
136
|
+
|
|
137
|
+
return new_width, new_height
|
|
138
|
+
|
|
139
|
+
def optimize_video(
|
|
140
|
+
self,
|
|
141
|
+
input_path: Path,
|
|
142
|
+
output_path: Path,
|
|
143
|
+
max_width: Optional[int] = None,
|
|
144
|
+
max_height: Optional[int] = None,
|
|
145
|
+
target_fps: Optional[float] = None,
|
|
146
|
+
crf: int = 23,
|
|
147
|
+
audio_bitrate: str = '128k',
|
|
148
|
+
preset: str = 'medium',
|
|
149
|
+
two_pass: bool = False
|
|
150
|
+
) -> bool:
|
|
151
|
+
"""Optimize a video file."""
|
|
152
|
+
# Get input video info
|
|
153
|
+
info = self.get_video_info(input_path)
|
|
154
|
+
if not info:
|
|
155
|
+
print(f"Error: Could not read video info for {input_path}", file=sys.stderr)
|
|
156
|
+
return False
|
|
157
|
+
|
|
158
|
+
if self.verbose:
|
|
159
|
+
print(f"\nInput video info:")
|
|
160
|
+
print(f" Resolution: {info.width}x{info.height}")
|
|
161
|
+
print(f" FPS: {info.fps:.2f}")
|
|
162
|
+
print(f" Bitrate: {info.bitrate // 1000} kbps")
|
|
163
|
+
print(f" Size: {info.size / (1024*1024):.2f} MB")
|
|
164
|
+
|
|
165
|
+
# Calculate target resolution
|
|
166
|
+
target_width, target_height = self.calculate_target_resolution(
|
|
167
|
+
info.width, info.height, max_width, max_height
|
|
168
|
+
)
|
|
169
|
+
|
|
170
|
+
# Build FFmpeg command
|
|
171
|
+
cmd = ['ffmpeg', '-i', str(input_path)]
|
|
172
|
+
|
|
173
|
+
# Video filters
|
|
174
|
+
filters = []
|
|
175
|
+
if target_width != info.width or target_height != info.height:
|
|
176
|
+
filters.append(f'scale={target_width}:{target_height}')
|
|
177
|
+
|
|
178
|
+
if filters:
|
|
179
|
+
cmd.extend(['-vf', ','.join(filters)])
|
|
180
|
+
|
|
181
|
+
# Frame rate adjustment
|
|
182
|
+
if target_fps and target_fps < info.fps:
|
|
183
|
+
cmd.extend(['-r', str(target_fps)])
|
|
184
|
+
|
|
185
|
+
# Video encoding
|
|
186
|
+
if two_pass:
|
|
187
|
+
# Two-pass encoding for better quality
|
|
188
|
+
target_bitrate = int(info.bitrate * 0.7) # 30% reduction
|
|
189
|
+
|
|
190
|
+
# Pass 1
|
|
191
|
+
pass1_cmd = cmd + [
|
|
192
|
+
'-c:v', 'libx264',
|
|
193
|
+
'-preset', preset,
|
|
194
|
+
'-b:v', str(target_bitrate),
|
|
195
|
+
'-pass', '1',
|
|
196
|
+
'-an',
|
|
197
|
+
'-f', 'null',
|
|
198
|
+
'/dev/null' if sys.platform != 'win32' else 'NUL'
|
|
199
|
+
]
|
|
200
|
+
|
|
201
|
+
if self.verbose or self.dry_run:
|
|
202
|
+
print(f"Pass 1: {' '.join(pass1_cmd)}")
|
|
203
|
+
|
|
204
|
+
if not self.dry_run:
|
|
205
|
+
try:
|
|
206
|
+
subprocess.run(pass1_cmd, check=True, capture_output=not self.verbose)
|
|
207
|
+
except subprocess.CalledProcessError as e:
|
|
208
|
+
print(f"Error in pass 1: {e}", file=sys.stderr)
|
|
209
|
+
return False
|
|
210
|
+
|
|
211
|
+
# Pass 2
|
|
212
|
+
cmd.extend([
|
|
213
|
+
'-c:v', 'libx264',
|
|
214
|
+
'-preset', preset,
|
|
215
|
+
'-b:v', str(target_bitrate),
|
|
216
|
+
'-pass', '2'
|
|
217
|
+
])
|
|
218
|
+
else:
|
|
219
|
+
# Single-pass CRF encoding
|
|
220
|
+
cmd.extend([
|
|
221
|
+
'-c:v', 'libx264',
|
|
222
|
+
'-preset', preset,
|
|
223
|
+
'-crf', str(crf)
|
|
224
|
+
])
|
|
225
|
+
|
|
226
|
+
# Audio encoding
|
|
227
|
+
cmd.extend([
|
|
228
|
+
'-c:a', 'aac',
|
|
229
|
+
'-b:a', audio_bitrate
|
|
230
|
+
])
|
|
231
|
+
|
|
232
|
+
# Output
|
|
233
|
+
cmd.extend(['-movflags', '+faststart', '-y', str(output_path)])
|
|
234
|
+
|
|
235
|
+
if self.verbose or self.dry_run:
|
|
236
|
+
print(f"Command: {' '.join(cmd)}")
|
|
237
|
+
|
|
238
|
+
if self.dry_run:
|
|
239
|
+
return True
|
|
240
|
+
|
|
241
|
+
# Execute
|
|
242
|
+
try:
|
|
243
|
+
subprocess.run(cmd, check=True, capture_output=not self.verbose)
|
|
244
|
+
|
|
245
|
+
# Get output info
|
|
246
|
+
output_info = self.get_video_info(output_path)
|
|
247
|
+
if output_info and self.verbose:
|
|
248
|
+
print(f"\nOutput video info:")
|
|
249
|
+
print(f" Resolution: {output_info.width}x{output_info.height}")
|
|
250
|
+
print(f" FPS: {output_info.fps:.2f}")
|
|
251
|
+
print(f" Bitrate: {output_info.bitrate // 1000} kbps")
|
|
252
|
+
print(f" Size: {output_info.size / (1024*1024):.2f} MB")
|
|
253
|
+
reduction = (1 - output_info.size / info.size) * 100
|
|
254
|
+
print(f" Size reduction: {reduction:.1f}%")
|
|
255
|
+
|
|
256
|
+
return True
|
|
257
|
+
|
|
258
|
+
except subprocess.CalledProcessError as e:
|
|
259
|
+
print(f"Error optimizing video: {e}", file=sys.stderr)
|
|
260
|
+
return False
|
|
261
|
+
except Exception as e:
|
|
262
|
+
print(f"Error optimizing video: {e}", file=sys.stderr)
|
|
263
|
+
return False
|
|
264
|
+
finally:
|
|
265
|
+
# Clean up two-pass log files
|
|
266
|
+
if two_pass and not self.dry_run:
|
|
267
|
+
for log_file in Path('.').glob('ffmpeg2pass-*.log*'):
|
|
268
|
+
log_file.unlink(missing_ok=True)
|
|
269
|
+
|
|
270
|
+
def compare_videos(self, original: Path, optimized: Path) -> None:
|
|
271
|
+
"""Compare original and optimized videos."""
|
|
272
|
+
orig_info = self.get_video_info(original)
|
|
273
|
+
opt_info = self.get_video_info(optimized)
|
|
274
|
+
|
|
275
|
+
if not orig_info or not opt_info:
|
|
276
|
+
print("Error: Could not compare videos", file=sys.stderr)
|
|
277
|
+
return
|
|
278
|
+
|
|
279
|
+
print(f"\n{'Metric':<20} {'Original':<20} {'Optimized':<20} {'Change':<15}")
|
|
280
|
+
print("-" * 75)
|
|
281
|
+
|
|
282
|
+
# Resolution
|
|
283
|
+
orig_res = f"{orig_info.width}x{orig_info.height}"
|
|
284
|
+
opt_res = f"{opt_info.width}x{opt_info.height}"
|
|
285
|
+
print(f"{'Resolution':<20} {orig_res:<20} {opt_res:<20}")
|
|
286
|
+
|
|
287
|
+
# FPS
|
|
288
|
+
fps_change = opt_info.fps - orig_info.fps
|
|
289
|
+
print(f"{'FPS':<20} {orig_info.fps:<20.2f} {opt_info.fps:<20.2f} {fps_change:+.2f}")
|
|
290
|
+
|
|
291
|
+
# Bitrate
|
|
292
|
+
orig_br = f"{orig_info.bitrate // 1000} kbps"
|
|
293
|
+
opt_br = f"{opt_info.bitrate // 1000} kbps"
|
|
294
|
+
br_change = ((opt_info.bitrate / orig_info.bitrate) - 1) * 100
|
|
295
|
+
print(f"{'Bitrate':<20} {orig_br:<20} {opt_br:<20} {br_change:+.1f}%")
|
|
296
|
+
|
|
297
|
+
# Size
|
|
298
|
+
orig_size = f"{orig_info.size / (1024*1024):.2f} MB"
|
|
299
|
+
opt_size = f"{opt_info.size / (1024*1024):.2f} MB"
|
|
300
|
+
size_reduction = (1 - opt_info.size / orig_info.size) * 100
|
|
301
|
+
print(f"{'Size':<20} {orig_size:<20} {opt_size:<20} {-size_reduction:.1f}%")
|
|
302
|
+
|
|
303
|
+
|
|
304
|
+
def main():
|
|
305
|
+
"""Main entry point."""
|
|
306
|
+
parser = argparse.ArgumentParser(
|
|
307
|
+
description='Video size optimization with quality/size balance.'
|
|
308
|
+
)
|
|
309
|
+
parser.add_argument(
|
|
310
|
+
'input',
|
|
311
|
+
type=Path,
|
|
312
|
+
help='Input video file'
|
|
313
|
+
)
|
|
314
|
+
parser.add_argument(
|
|
315
|
+
'-o', '--output',
|
|
316
|
+
type=Path,
|
|
317
|
+
required=True,
|
|
318
|
+
help='Output video file'
|
|
319
|
+
)
|
|
320
|
+
parser.add_argument(
|
|
321
|
+
'-w', '--max-width',
|
|
322
|
+
type=int,
|
|
323
|
+
help='Maximum width in pixels'
|
|
324
|
+
)
|
|
325
|
+
parser.add_argument(
|
|
326
|
+
'-H', '--max-height',
|
|
327
|
+
type=int,
|
|
328
|
+
help='Maximum height in pixels'
|
|
329
|
+
)
|
|
330
|
+
parser.add_argument(
|
|
331
|
+
'--fps',
|
|
332
|
+
type=float,
|
|
333
|
+
help='Target frame rate'
|
|
334
|
+
)
|
|
335
|
+
parser.add_argument(
|
|
336
|
+
'--crf',
|
|
337
|
+
type=int,
|
|
338
|
+
default=23,
|
|
339
|
+
help='CRF quality (18-28, lower=better, default: 23)'
|
|
340
|
+
)
|
|
341
|
+
parser.add_argument(
|
|
342
|
+
'--audio-bitrate',
|
|
343
|
+
default='128k',
|
|
344
|
+
help='Audio bitrate (default: 128k)'
|
|
345
|
+
)
|
|
346
|
+
parser.add_argument(
|
|
347
|
+
'--preset',
|
|
348
|
+
choices=['ultrafast', 'superfast', 'veryfast', 'faster', 'fast',
|
|
349
|
+
'medium', 'slow', 'slower', 'veryslow'],
|
|
350
|
+
default='medium',
|
|
351
|
+
help='Encoding preset (default: medium)'
|
|
352
|
+
)
|
|
353
|
+
parser.add_argument(
|
|
354
|
+
'--two-pass',
|
|
355
|
+
action='store_true',
|
|
356
|
+
help='Use two-pass encoding (better quality)'
|
|
357
|
+
)
|
|
358
|
+
parser.add_argument(
|
|
359
|
+
'--compare',
|
|
360
|
+
action='store_true',
|
|
361
|
+
help='Compare original and optimized videos'
|
|
362
|
+
)
|
|
363
|
+
parser.add_argument(
|
|
364
|
+
'-n', '--dry-run',
|
|
365
|
+
action='store_true',
|
|
366
|
+
help='Show command without executing'
|
|
367
|
+
)
|
|
368
|
+
parser.add_argument(
|
|
369
|
+
'-v', '--verbose',
|
|
370
|
+
action='store_true',
|
|
371
|
+
help='Verbose output'
|
|
372
|
+
)
|
|
373
|
+
|
|
374
|
+
args = parser.parse_args()
|
|
375
|
+
|
|
376
|
+
# Validate input
|
|
377
|
+
if not args.input.exists():
|
|
378
|
+
print(f"Error: Input file not found: {args.input}", file=sys.stderr)
|
|
379
|
+
sys.exit(1)
|
|
380
|
+
|
|
381
|
+
# Initialize optimizer
|
|
382
|
+
optimizer = VideoOptimizer(verbose=args.verbose, dry_run=args.dry_run)
|
|
383
|
+
|
|
384
|
+
# Check dependencies
|
|
385
|
+
if not optimizer.check_ffmpeg():
|
|
386
|
+
print("Error: FFmpeg not found", file=sys.stderr)
|
|
387
|
+
sys.exit(1)
|
|
388
|
+
|
|
389
|
+
# Optimize video
|
|
390
|
+
print(f"Optimizing {args.input.name}...")
|
|
391
|
+
success = optimizer.optimize_video(
|
|
392
|
+
args.input,
|
|
393
|
+
args.output,
|
|
394
|
+
args.max_width,
|
|
395
|
+
args.max_height,
|
|
396
|
+
args.fps,
|
|
397
|
+
args.crf,
|
|
398
|
+
args.audio_bitrate,
|
|
399
|
+
args.preset,
|
|
400
|
+
args.two_pass
|
|
401
|
+
)
|
|
402
|
+
|
|
403
|
+
if not success:
|
|
404
|
+
sys.exit(1)
|
|
405
|
+
|
|
406
|
+
# Compare if requested
|
|
407
|
+
if args.compare and not args.dry_run:
|
|
408
|
+
optimizer.compare_videos(args.input, args.output)
|
|
409
|
+
|
|
410
|
+
print(f"\nOptimized video saved to: {args.output}")
|
|
411
|
+
|
|
412
|
+
|
|
413
|
+
if __name__ == '__main__':
|
|
414
|
+
main()
|