How much time will I actually save with Fazm?

Most users report saving 45-90 minutes per day on repetitive tasks. The biggest time savings come from email management (drafting replies, sorting, archiving), form filling (expense reports, CRM updates, applications), research (comparing products, gathering data from multiple sites), and social media (cross-posting, scheduling, replying). For example, booking a flight that normally takes 10 minutes of clicking through airline sites takes a single voice command with Fazm. Filing an expense report that requires opening a PDF, extracting numbers, and entering them into a spreadsheet becomes one spoken sentence. The more repetitive and multi-step your daily work is, the more time you get back.

What exactly can Fazm control?

Fazm controls everything you can do manually on your Mac. That includes mouse movements and clicks, keyboard typing, browser navigation and form filling, app switching, file management in Finder, and system-level actions. It uses direct browser DOM control for web interactions - meaning it reads and manipulates the actual page structure rather than taking screenshots and guessing where to click. For native macOS apps, Fazm uses accessibility APIs to interact with buttons, menus, text fields, and other UI elements. This works across any application: Chrome, Safari, VS Code, Slack, Figma, Terminal, Mail, Calendar, and more.

How is Fazm different from ChatGPT or Claude?

Chatbots like ChatGPT and Claude give you answers in a conversation window. Fazm takes action directly on your computer. When you say 'reply to Sarah's email,' Fazm opens your email app, finds Sarah's message, writes a contextual reply, and sends it. A chatbot would tell you what to write, but you still have to do all the clicking and typing yourself. Fazm moves your mouse, types on your keyboard, clicks buttons, and navigates between apps. It is a computer agent, not a chat assistant.

How does the memory layer work?

Fazm builds a personal knowledge graph by extracting information from your files, browsing history, conversations, and daily activity. Over time, it learns your contacts (names, emails, relationships), accounts and credentials, preferences (formatting, tone, scheduling habits), and frequently used workflows. In your first week, you might say 'Reply to Sarah's email, she's my cofounder, her email is sarah@acme.com.' By week four, you just say 'Reply to Sarah' because Fazm already knows who she is. By week eight, Fazm can draft the reply before you even ask. All of this data stays locally on your Mac - your knowledge graph never leaves your machine or gets sent to any cloud service.

Is Fazm safe? Can it mess up my computer?

Safety is built into every layer of Fazm. You watch every action in real-time on your screen - Fazm moves your mouse and types visibly, so there is nothing hidden. You can stop any action at any point by pressing a keyboard shortcut. Fazm also shows you what it plans to do before executing destructive actions like deleting files or sending emails, giving you a chance to confirm or cancel. Because Fazm is open source, the code is fully auditable on GitHub. There is no hidden behavior, no background processes making changes you cannot see, and no actions that bypass your screen.

What platforms does Fazm support?

Fazm currently supports macOS, running natively on both Apple Silicon (M1, M2, M3, M4) and Intel Macs. It is built with Swift and uses macOS-specific frameworks like ScreenCaptureKit for screen analysis and Accessibility APIs for app control, which is why macOS is the primary platform. Windows and Linux support are on the roadmap but do not have release dates yet. You can also control your Mac remotely from your phone using Fazm Remote, which gives you voice access to your desktop while you are away from your computer.

How does Fazm voice input work?

One keyboard shortcut activates push-to-talk. Hold the key, speak naturally about what you need done, and release. Fazm transcribes your speech locally using on-device models, so there is no network latency for the voice recognition step. You do not need wake words like 'Hey Siri' or 'OK Google' - just press and talk. You can also type commands into the floating toolbar if you prefer text input. Fazm understands natural language, so you do not need to memorize specific commands. Say 'book me a flight to Tokyo next Thursday' or 'find the cheapest AirPods on Amazon' and Fazm figures out the steps.

Is my data sent to the cloud?

Fazm processes screen analysis and memory entirely on your machine. The personal knowledge graph, file indexing, and screen capture all run locally. The only data that leaves your Mac is the intent - a text description of what you want to accomplish, which is sent to the AI model (Claude or GPT) for action planning. Your actual screen content, file contents, browsing history, and personal knowledge graph never leave your computer. Fazm is also open source, so you can verify exactly what data is transmitted by reading the code on GitHub. For users who need complete air-gapped operation, local model support is planned.

Back to Blog

How to Embed Demo Videos in Your GitHub README with FFmpeg

Fazm Team·March 17, 2026·2 min read

githubdemo-videoffmpegreadmeopen-source

How to Embed Demo Videos in Your GitHub README with FFmpeg

A good demo video in your README is worth more than a thousand words of documentation. But GitHub has a 10MB file size limit for uploads, and raw screen recordings are usually way bigger than that. FFmpeg makes this solvable in one command.

Compress First

Start with a basic compression pass that targets a reasonable file size:

ffmpeg -i raw-demo.mov -vcodec libx264 -crf 28 -preset slow -vf scale=1280:-2 -an demo-compressed.mp4

The -crf 28 flag controls quality - higher numbers mean smaller files but lower quality. For most README demos, 28 is a sweet spot. The -vf scale=1280:-2 resizes to 1280px wide, which is plenty for a README. And -an strips audio since most demo videos don't need it.

If your video is still over 10MB, bump the CRF up to 32 or shorten the clip. A 20-second demo at 1280px wide with CRF 28 usually lands around 2-4MB.

Get a CDN URL

GitHub doesn't let you commit large binaries to a repo without LFS, but there is a trick. Open any issue on your repo, drag the compressed video into the comment box, and GitHub uploads it to their CDN. You get a URL like https://github.com/user-attachments/assets/... before you even submit the issue.

Copy that URL and drop it into your README:

https://github.com/user-attachments/assets/your-video-id.mp4

GitHub renders this as an inline video player. No iframe, no external hosting, no dependencies.

Keep It Short

The best demo videos are 10-30 seconds. Show one workflow, one feature, one thing your tool does well. If you need to show multiple features, make multiple short videos rather than one long one.

Fazm is an open source macOS AI agent. Open source on GitHub.

How to Embed Demo Videos in Your GitHub README with FFmpeg

How to Embed Demo Videos in Your GitHub README with FFmpeg

Compress First

Get a CDN URL

Keep It Short

Related Posts

Why Your AI Agent Needs a Firewall - And Why It Should Be Open Source

Launching an Open Source AI Agent - Why YouTube Demos Matter More Than Feature Lists

Open Source AI Agents for Task Execution - Why Memory Sets Them Apart