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
Install
npm install -g @reels/tuiPrerequisites
Terminal
You need a terminal that supports the Kitty graphics protocol:
Chrome (LINUX ARM64 ONLY)
Chrome is automatically downloaded on first run if no system Chrome/Chromium is found; No action is needed for most platforms. The exception is Linux ARM64, where Chrome For Testing isn't available yet (coming Q2 2026!). If you are on Linux ARM64, you'll need to install Chromium manually before running Reels.
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_repost |
r |
Repost/unrepost current reel |
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/