Package Exports
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@reels/tui) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
reels
TUI for Instagram Reels. Doomscrollbrainrotmaxxing in the terminal.
Install
npm install -g @reels/tuiPrerequisites
Terminal
You need a terminal that supports the Kitty graphics protocol:
Browser
Chrome, Chromium, or Brave must be installed. The app uses headless browser automation to interact with Instagram.
FFmpeg
macOS:
Requires ffmpeg-full from Homebrew - brew install ffmpeg-full. The standard brew install ffmpeg will not work. You may also build FFmpeg 8+ from source or use MacPorts, as long as the Apple framework dependencies (VideoToolbox, AudioToolbox, etc.) are properly included.
Linux:
Any FFmpeg 8+ from your package manager (e.g. pacman -S ffmpeg, apt install ffmpeg).
Usage
reelsFlags
--headed- Run browser in headed mode (visible browser window)--login- Open browser window to log in to Instagram
Controls
| reels.conf bind | Default | Action |
|---|---|---|
key_next |
j |
Next reel (scrolls panels when open) |
key_previous |
k |
Previous reel (scrolls panels when open) |
key_seek_backward |
h |
Seek backward by 5 seconds |
key_seek_forward |
l |
Seek forward by 5 seconds |
key_like |
space |
Like/unlike |
key_share_select |
space |
Select friend in share panel. Overrides any other bind while share panel is open |
key_pause |
p |
Pause/resume current reel |
key_save |
b |
Save/Unsave (bookmark) current reel |
key_navbar |
e |
Toggle navbar, a condensed version of the help menu |
key_comments_open |
c |
Open comments |
key_comments_close |
C |
Close comments |
key_share_open |
s |
Open share panel. Allows you to share reels with instagram's suggested top friends. |
key_share_close |
S |
Close Share panel & sends to friends' DMs (if any are selected) |
key_copy_link |
y |
Copy reel link to clipboard |
key_mute |
m |
Mute current reel |
key_vol_up |
] |
Volume up |
key_vol_down |
[ |
Volume down |
key_reel_size_inc |
= |
Enlarge video |
key_reel_size_dec |
- |
Shrink video |
key_help_open |
? |
Help panel shows the current keybinds |
key_help_close |
? |
Close help panel |
key_quit |
q |
Quit |
key_quit |
ctrl+c |
Quit |
All keybinds are configurable in reels.conf. Each action supports multiple binds. Open/close pairs (like key_comments_open and key_comments_close) can be bound to the same key to toggle.
Supported Platforms
| Platform | Package |
|---|---|
| Linux x64 | @reels/linux-x64 |
| Linux ARM64 | @reels/linux-arm64 |
| macOS ARM64 | @reels/darwin-arm64 |
File Paths
- Settings:
~/.config/reels/reels.conf - Cache:
~/.cache/reels/ - Chrome Data:
~/.local/shared/reels/