A comprehensive repository for long and short form technical content production. Each video lives in its own directory with presentation slides, demo scripts, and diagrams.

• Overview
• Quick Start
• Repository Structure
• Tool Installation
• Justfile Recipes
• Workflow Examples
• Documentation

This repository contains scripts, presentations, and diagrams for technical video content. Each video directory follows a consistent structure:

• Presentation files: slides.md or presentation.md (rendered with presenterm)
• Demo scripts: Optional demo.sh with executable commands
• Diagrams: PlantUML (.puml) or graph-easy (.dot) files in diagrams/ subdirectory
• Theme files: Custom theme.json for presenterm styling

• Terminal-based presentations with live code execution
• Automated diagram rendering in slides
• Demo scripts with typed command simulation
• Reusable templates and partials
• Just-based automation for common workflows

# Clone the repository
git clone <repo-url>
cd youtube

# Create a new video folder from template
just start my-new-video "My Awesome Title"

# Edit the presentation
cd my-new-video
nvim presentation.md

# Run the presentation
just present

# Navigate to any video directory
cd bash-scripting

# Run the presentation
just present

# Or execute the demo script
./demo.sh

youtube/
├── README.md                    # This file
├── WORKFLOWS.md                 # Detailed workflow documentation
├── TOOLS.md                     # Tool installation and configuration
├── justfile                     # Automation recipes
├── slides_template.md           # Template for new presentations
├── theme.json                   # Default presenterm theme
├── __demo_magic.sh              # Demo script utilities
├── __questions.sh               # Interactive quiz utilities
├── __tmux_timer.sh              # Timer utilities for demos
├── _partials/                   # Reusable slide components
│   └── *.md
├── templates/                   # Additional templates
├── [video-name]/                # Individual video directories
│   ├── presentation.md          # Presentation slides
│   ├── demo.sh                  # Optional demo script
│   ├── theme.json               # Optional custom theme
│   └── diagrams/                # Diagram source files
│       ├── *.puml               # PlantUML diagrams
│       └── *.dot                # graph-easy diagrams
└── test-*/                      # Interactive quiz videos

The repository contains 86 video directories covering:

• Vim/Neovim: Editor configurations, plugins, keybindings
• tmux: Session management, notifications, layouts
• Bash/Shell: Scripting, exercises, automation
• Kubernetes: Deployments, debugging, schedulers
• DevOps: Docker, CI/CD, infrastructure
• Terminal Tools: CLI utilities, productivity tools
• Taskwarrior: Task management and automation
• Interactive Tests: Quiz-based learning videos

# Presenterm - Terminal presentation tool
cargo install presenterm

# Just - Command runner
cargo install just

# tmux - Terminal multiplexer
sudo apt-get install tmux  # Debian/Ubuntu
brew install tmux          # macOS

# pv - Pipe viewer for demo scripts
sudo apt-get install pv    # Debian/Ubuntu
brew install pv            # macOS

# PlantUML - UML diagram generation
sudo apt-get install plantuml  # Debian/Ubuntu
brew install plantuml          # macOS

# graph-easy - ASCII diagram tool
sudo apt-get install libgraph-easy-perl  # Debian/Ubuntu
cpan Graph::Easy                         # From CPAN

# figlet - ASCII art text
sudo apt-get install figlet  # Debian/Ubuntu
brew install figlet          # macOS

# toilet - Advanced ASCII art
sudo apt-get install toilet  # Debian/Ubuntu
brew install toilet          # macOS

# boxes - Text box drawing
sudo apt-get install boxes   # Debian/Ubuntu
brew install boxes           # macOS

# glow - Markdown renderer
go install github.com/charmbracelet/glow@latest

# typos - Spell checker
cargo install typos-cli

# VHS - Terminal recorder (for GIF creation)
go install github.com/charmbracelet/vhs@latest

# D2 - Modern diagram scripting
curl -fsSL https://d2lang.com/install.sh | sh -s --

For detailed installation instructions, see TOOLS.md.

The justfile provides automation for common tasks:

just                    # List all available recipes
just list_videos        # List all video directories with dates

just start <folder> [title]     # Create new video folder with template
just present                    # Run presentation in current directory
just intro <text>               # Generate ASCII art intro (figlet)
just intro_toilet <text>        # Generate ASCII art intro (toilet)
just freetext <text>            # Display formatted free text

just plantuml <diagram>         # Render PlantUML diagram to ASCII
just digraph <diagram>          # Render graph-easy diagram to ASCII

just tmux_demo                  # Create tmux demo session

# Create a new video about Docker
just start docker-fundamentals "Docker Fundamentals"

# Render a PlantUML diagram
cd kubernetes-deployments
just plantuml architecture

# Render a graph-easy diagram
cd mcp-agentic-framework
just digraph mcp-overview

# Generate title slide
just intro_toilet "Welcome to Vim!"

1. Initialize the video directory:

   just start my-topic "My Topic Title"
   cd my-topic

2. Edit the presentation:

   nvim presentation.md

3. Add diagrams (if needed):

   mkdir -p diagrams
   # Create .puml or .dot files in diagrams/

4. Test the presentation:

   just present

5. Create demo script (optional):

   cat > demo.sh << 'EOF'
   #!/usr/bin/env bash
   source ../__demo_magic.sh
   # Add demo commands
   EOF
   chmod +x demo.sh

Use code blocks with +exec_replace to render diagrams dynamically:

PlantUML:

```bash +exec_replace
just plantuml my-diagram
```​

graph-easy:

```bash +exec_replace
just digraph my-diagram
```​

Demo scripts use the __demo_magic.sh utility for typed command simulation:

#!/usr/bin/env bash
source ../__demo_magic.sh

clear_screen
pe "echo 'Hello World'"
pe "ls -la"
wait

For detailed workflows, see WORKFLOWS.md.

• WORKFLOWS.md - Step-by-step guides for common workflows
• TOOLS.md - Comprehensive tool documentation and configuration
• demo-magic - Inspiration for __demo_magic.sh

The script runner __demo_magic.sh is inspired by the excellent demo-magic repository, which allows for simulating command typing and output in a terminal.

Minimum requirements to use this repository:

• tmux - Terminal multiplexer
• pv - Pipe viewer for animations
• presenterm - Terminal presentation tool
• just - Command runner

See TOOLS.md for complete installation instructions.

Video content structure:

1. Each video in its own directory
2. Use slides_template.md as starting point
3. Follow naming conventions (lowercase with hyphens)
4. Include diagrams in diagrams/ subdirectory
5. Document any special prerequisites in video directory

MIT License - Feel free to use these scripts and presentations for your own content creation.