https://github.com/siliconlemon/panelizer-tui
A TUI (terminal user interface) tool for laying out picturess onto clean, instagram-ready carousel panels. Fits each picture onto one or two portrait-mode panels (4:5 or 3:4), based on proportional padding for both the horizontal and vertical axis.
https://github.com/siliconlemon/panelizer-tui
carousel cli free graphics image-processing instagram open-source python tui
Last synced: 3 months ago
JSON representation
A TUI (terminal user interface) tool for laying out picturess onto clean, instagram-ready carousel panels. Fits each picture onto one or two portrait-mode panels (4:5 or 3:4), based on proportional padding for both the horizontal and vertical axis.
- Host: GitHub
- URL: https://github.com/siliconlemon/panelizer-tui
- Owner: siliconlemon
- License: mit
- Created: 2025-08-30T17:56:50.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2026-01-14T12:27:57.000Z (5 months ago)
- Last Synced: 2026-01-14T16:44:42.523Z (5 months ago)
- Topics: carousel, cli, free, graphics, image-processing, instagram, open-source, python, tui
- Language: Python
- Homepage:
- Size: 26.7 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Panelizer TUI
A TUI (terminal user interface) tool for laying out pictures onto clean, instagram-ready carousel panels.
## Features
- A fast and lightweight TUI utilizing `textual-neon`, an opinionated superset of `textual` and `textual_fspicker`.
- Works with all common aspect ratios like 3:4, 4:5, 3:2, and anything between 16:9 and 5:2.
- Fits each picture onto one or two portrait-mode panels (4:5 or 3:4), based on proportional padding for both the horizontal and vertical axis.
- In Constant Border mode, the panels are padded with a constant border, defined by a percentage of the image's width.
## Pricing
This project is open-source and free, forever.
## Contributions
Open to issues and pull requests. If you’ve got a cool idea, improvement suggestion, or a weird edge case, let me know.
## Running in dev mode
The `panelizer.app` module's UI unfortunately does not work in Pycharm's integrated terminal, this might be an issue
with other IDEs as well. Run the module in WT or another dedicated external terminal with support from `textual`
for this to work properly.
- **Install dependencies:** In your project's root directory, run `pip install .` to install all required packages.
- **Run as a module:** Open a new, external terminal and execute `python -m panelizer.app`.
## License
MIT License ([@siliconlemon](https://github.com/siliconlemon)) — see [LICENSE](LICENSE) for full text.