danielmiessler.fabric/docs
Kayvan Sylvan 645190be3a feat: update REST API docs with new fields and examples
### CHANGES

- Add detailed prompt fields table with defaults
- Introduce chat options table with new parameters
- Include complete workflow examples for YouTube summary
- Provide alternative script and CLI comparison for flexibility
2025-12-18 07:30:34 -08:00
..
images feat: add -V/--vendor flag and vendor-aware model selection 2025-08-12 06:39:02 -07:00
voices feat: add Gemini TTS voice selection and listing functionality 2025-07-26 15:11:30 -07:00
Automated-Changelog-Usage.md docs: Remove duplicated section. 2025-07-21 11:07:27 -07:00
Automated-ChangeLog.md feat: enhance changelog generator to accept version parameter for PR processing 2025-07-21 07:36:30 -07:00
CODE_OF_CONDUCT.md docs: add contributing, security, support, and code-of-conduct docs; add docs index 2025-08-26 07:10:08 -07:00
contexts-and-sessions-tutorial.md feat: add i18n support with Spanish localization and documentation improvements 2025-09-08 09:17:23 -07:00
CONTRIBUTING.md # CHANGES 2025-12-18 07:12:08 -08:00
Desktop-Notifications.md feat(cli): add cross-platform desktop notifications with secure custom commands 2025-08-08 00:20:51 -07:00
docs.go # CHANGES 2025-12-18 07:12:08 -08:00
Gemini-TTS.md docs: update Gemini TTS model references to gemini-2.5-flash-preview-tts 2025-07-26 16:23:56 -07:00
GitHub-Models-Setup.md feat: add GitHub Models provider and refactor model fetching with direct API fallback 2025-11-23 15:02:33 +07:00
Go-Updates-September-2025.md chore: Go 1.25 upgrade and critical package updates for AI/ML services 2025-09-14 10:22:25 -07:00
i18n-variants.md feat(i18n): add i18n support for language variants (pt-BR/pt-PT) 2025-09-21 16:04:59 -07:00
i18n.md feat: add i18n support with Spanish localization and documentation improvements 2025-09-08 09:17:23 -07:00
NOTES.md refactor: restructure project to align with standard Go layout 2025-07-08 22:47:17 -07:00
notification-config.yaml feat(cli): add cross-platform desktop notifications with secure custom commands 2025-08-08 00:20:51 -07:00
Project-Restructured.md fix: minor edit 2025-07-09 00:24:35 -07:00
README.md docs: add contributing, security, support, and code-of-conduct docs; add docs index 2025-08-26 07:10:08 -07:00
rest-api.md feat: update REST API docs with new fields and examples 2025-12-18 07:30:34 -08:00
SECURITY.md docs: add contributing, security, support, and code-of-conduct docs; add docs index 2025-08-26 07:10:08 -07:00
Shell-Completions.md docs: add quick install method for shell completions without cloning repo 2025-08-12 10:00:11 -07:00
SUPPORT.md docs: add contributing, security, support, and code-of-conduct docs; add docs index 2025-08-26 07:10:08 -07:00
swagger.json # CHANGES 2025-12-18 07:12:08 -08:00
swagger.yaml # CHANGES 2025-12-18 07:12:08 -08:00
Using-Speech-To-Text.md feat: add --debug flag with levels and centralized logging 2025-08-19 04:23:40 -07:00
YouTube-Processing.md feat: add -V/--vendor flag and vendor-aware model selection 2025-08-12 06:39:02 -07:00

Fabric Documentation

Welcome to the Fabric documentation! This directory contains detailed guides and technical documentation for various features and components of Fabric.

📚 Available Documentation

Core Features

Automated-Changelog-Usage.md Complete guide for developers on using the automated changelog system. Covers the workflow for generating PR changelog entries during development, including setup, validation, and CI/CD integration.

YouTube-Processing.md Comprehensive guide for processing YouTube videos and playlists with Fabric. Covers transcript extraction, comment processing, metadata retrieval, and advanced yt-dlp configurations.

Using-Speech-To-Text.md Documentation for Fabric's speech-to-text capabilities using OpenAI's Whisper models. Learn how to transcribe audio and video files and process them through Fabric patterns.

User Interface & Experience

Desktop-Notifications.md Guide to setting up desktop notifications for Fabric commands. Useful for long-running tasks and multitasking scenarios with cross-platform notification support.

Shell-Completions.md Instructions for setting up intelligent tab completion for Fabric in Zsh, Bash, and Fish shells. Includes automated installation and manual setup options.

Gemini-TTS.md Complete guide for using Google Gemini's text-to-speech features with Fabric. Covers voice selection, audio generation, and integration with Fabric patterns.

Development & Architecture

Automated-ChangeLog.md Technical documentation outlining the automated CHANGELOG system architecture for CI/CD integration. Details the infrastructure and workflow for maintainers.

Project-Restructured.md Project restructuring plan and architectural decisions. Documents the transition to standard Go conventions and project organization improvements.

NOTES.md Development notes on refactoring efforts, model management improvements, and architectural changes. Includes technical details on vendor and model abstraction.

Audio Resources

voices/README.md Index of Gemini TTS voice samples demonstrating different AI voice characteristics available in Fabric.

🗂️ Additional Resources

Configuration Files

  • ./notification-config.yaml - Example notification configuration

Images

  • images/ - Screenshots and visual documentation assets
    • fabric-logo-gif.gif - Animated Fabric logo
    • fabric-summarize.png - Screenshot of summarization feature
    • svelte-preview.png - Web interface preview

🚀 Quick Start

New to Fabric? Start with these essential docs:

  1. ../README.md - Main project README with installation and basic usage
  2. Shell-Completions.md - Set up tab completion for better CLI experience
  3. YouTube-Processing.md - Learn one of Fabric's most popular features
  4. Desktop-Notifications.md - Get notified when long tasks complete

🔧 For Contributors

Contributing to Fabric? These docs are essential:

  1. ./CONTRIBUTING.md - Contribution guidelines and setup
  2. Automated-Changelog-Usage.md - Required workflow for PR submissions
  3. Project-Restructured.md - Understanding project architecture
  4. NOTES.md - Current development priorities and patterns

📝 Documentation Standards

When adding new documentation:

  • Use clear, descriptive filenames
  • Include practical examples and use cases
  • Update this README index with your new docs
  • Follow the established markdown formatting conventions
  • Test all code examples before publication

For general help and support, see ./SUPPORT.md