Frames CLI — рамки устройств Apple для скриншотов и видео
frames-cli
CLI frames вставляет скриншоты и записи экрана в официальные рамки устройств Apple и сам определяет модель по размеру кадра
- 448 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- CLI скачивает пакет рамок с cdn.macstories.net и запускает `ffmpeg` и `ffprobe` на ваших файлах
- Результат пишется в каталог исходных файлов и может заменить одноименные `_framed`-файлы
Установка
- Работает в
Ручная установка
git clone https://github.com/viticci/frames-cli.git && cd frames-cli && pip3 install PillowДальше сделайте ссылку на файл `frames` в каталоге из PATH, например `ln -s "$(pwd)/frames" ~/.local/bin/frames`, и запустите `frames setup`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI скачивает пакет рамок с cdn.macstories.net и запускает `ffmpeg` и `ffprobe` на ваших файлах
- Результат пишется в каталог исходных файлов и может заменить одноименные `_framed`-файлы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
`frames` — однофайловый CLI на Python. Он берет скриншот или запись экрана, по размеру в пикселях определяет устройство и накладывает на кадр рамку Apple с выбранным цветом корпуса. Для одинаковых размеров берется рамка новейшего поколения, а нужную можно задать флагом `--device`. Результат сохраняется рядом с исходником под именем `имя_framed.png`. Снимки обрабатываются пачками: `frames *.png` или целая папка. Цвета задают флагом `-c` по имени или номеру, `-c random` выбирает цвет для каждого файла отдельно, а `--colors` назначает цвета списком. Флаг `-m` склеивает несколько кадров в один. Видео проходят через `frames video`: форматы `.mp4`, `.mov` и `.m4v`, звук сохраняется, пока не указан `--strip-audio`. Пресеты `compact`, `balanced` и `best` меняют размер и качество, а `--alpha` или `--codec hevc-alpha` дают прозрачный фон. Рамки не лежат в репозитории: `frames setup` скачивает пакет Apple Frames 4 примерно на 50 МБ. В пакет входят iPhone 18 Pro, iPhone 18 Pro Max, iPhone Duo и MacBook Pro с дисплеем PROLED. В репозитории есть и файл `skill/SKILL.md`: он объясняет агенту команды, флаги `--json` для автоматизации и диагностику через `frames doctor`.
Для кого. Авторам приложений для iOS и обзорщикам, которым нужны скриншоты и записи экрана с рамками устройств Apple для сайта, магазина приложений или статьи.
Подходит, если
- Для страницы приложения нужны снимки в рамке iPhone 18 Pro с цветом корпуса на выбор
- Папка из десятков скриншотов должна получить рамки одной командой
- Две записи экрана надо поставить рядом в одном ролике: одновременно или по очереди слева направо
- Для монтажа или презентации нужен ролик с прозрачным фоном
- Агент определяет устройство по размеру снимка и возвращает результат в формате JSON
Не подходит, если
- Рамки нужны для устройств не из пакета Apple Frames: список моделей берется из установленного пакета, его показывает `frames list`
- Фон должен быть сложнее белого, черного, цвета в hex или прозрачного: другой холст CLI не рисует
- Видео обрабатывается на машине без `ffmpeg` и `ffprobe` версии 5.1: для роликов они обязательны
Пример запроса к агенту
Поставь все скриншоты из папки Screenshots в рамки iPhone 18 Pro цвета Silver и сложи результат в папку framedОграничения
Нужны Python 3.8 и Pillow. Для видео нужны `ffmpeg` и `ffprobe` версии 5.1 или новее, а прозрачный HEVC работает только на macOS с сборкой ffmpeg, где есть VideoToolbox. Файлы ProRes 4444 заметно больше исходного ролика.
Пакет рамок скачивается с cdn.macstories.net командой `frames setup`; путь к нему лежит в `~/.config/frames/config.json` или в переменной `FRAMES_ASSETS`. Размеры iPhone Duo проверены в симуляторе Xcode 27.1, на устройстве их никто не сверял. Проект основан на ярлыке Apple Frames от MacStories и с Apple не связан.
Как отключить. Удалите ссылку `~/.local/bin/frames` и склонированную папку `frames-cli`. Пакет рамок лежит по пути из `~/.config/frames/config.json`, его можно удалить отдельно.
Частые вопросы
Как поставить Frames CLI?
Выполните `git clone https://github.com/viticci/frames-cli.git`, затем `pip3 install Pillow` и сделайте ссылку на файл `frames` в каталоге из PATH, например `~/.local/bin`. Проверьте `frames --version` и запустите `frames setup` для скачивания рамок.
Как подключить Frames CLI к Claude Code?
Скопируйте `skill/SKILL.md` из репозитория в папку скиллов агента, например в `~/.claude/skills/frames-cli/`. Отдельной команды установки скилла в README нет.
Какие устройства умеет рамить CLI?
Список зависит от скачанного пакета. Пакет Apple Frames 4 включает iPhone 18 Pro и 18 Pro Max, iPhone Duo и MacBook Pro с PROLED. Точные названия выводит `frames list`.
Как сделать ролик с прозрачным фоном?
Для сжатого файла на macOS используйте `frames video --codec hevc-alpha запись.mp4`, для монтажа `--alpha` даст ProRes 4444 в `.mov`. Путь вывода для обоих кодеков должен заканчиваться на `.mov`.
Работает ли CLI без ffmpeg?
Картинки обрабатываются без него. Видео требует `ffmpeg` и `ffprobe` 5.1 или новее, а `frames doctor` показывает, готов ли набор инструментов.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыНабор скиллов учит агента писать видео на TypeScript и рендерить его на GPU без браузера: композитинг, моушн-графика, 3D.
CLI сжимает видео до заданного размера локально через FFmpeg и показывает оценку качества VMAF и SSIM, есть скилл для агента
Скилл для Claude Code: из сырых клипов с говорящей головой делает рилс для Instagram, выбирает дубли и режет паузы
FrameJam дает агенту собирать видео в выбранном стиле и принимать правки по клику на кадр с отметкой времени
Скиллы и CLI от HeyGen: агент пишет HTML-композиции и рендерит из них MP4-ролики, субтитры, моушн-графику и слайды
Скилл и CLI, с которыми Claude Code или Codex делает видео как веб-страницы, а редактор Studio позволяет править результат
Коротко о README
В README разобраны установка, загрузка пакета рамок, таблицы размеров для iPhone 18 Pro, iPhone Duo и MacBook Pro с PROLED и быстрый старт с цветами, пакетной обработкой и склейкой. Ниже идут разделы про видео и настройки. Лицензия MIT.