@zesbe/tmux-termux

🤖 Tmux configuration optimized for Termux on Android

✨ Features

• 📱 Touch Screen Friendly - Perfect for mobile devices
• 🖱️ Mouse Scrolling - Scroll with mouse wheel or swipe
• ⚡ Optimized for Termux - Special settings for Android
• 🎯 Simple Setup - One command installation
• 📚 Useful Aliases - Pre-configured shortcuts

🚀 Quick Install

# Install via npm
npm install -g @zesbe/tmux-termux

# Or via pkg (Termux)
pkg install @zesbe/tmux-termux

# Run configuration
tmux-termux

📖 Usage

After installation:

# Start tmux with the new config
tmux

# Or use the alias
tm

# List sessions
tl

# Attach to session
ta session_name

🎮 Controls

Mouse/Touch

• Scroll - Mouse wheel or swipe gesture
• Click - Position cursor
• Drag - Select text
• Copy - After selection, use system copy

Keyboard Shortcuts

• Prefix + c - New window
• Prefix + | - Split horizontal
• Prefix + - - Split vertical
• Prefix + d - Detach session

Default Prefix: Ctrl + A

📱 Termux Specific

The configuration includes:

• Terminal override for Android
• Mouse support optimization
• Touch-friendly copy mode
• Performance tweaks for mobile

🔧 Requirements

• Termux app
• Node.js (for npm install)
• tmux package

# Install tmux if not installed
pkg update
pkg install tmux

📁 Configuration Location

Config file: ~/.tmux.conf Backup: ~/.tmux.conf.backup.TIMESTAMP

🐛 Troubleshooting

Scroll not working?

1. Restart tmux: tmux kill-server && tmux
2. Check config: cat ~/.tmux.conf
3. Ensure mouse is enabled: tmux show -g mouse

Can't copy/paste?

1. Enter copy mode: Prefix + [
2. Select text with touch/mouse
3. Copy with y or system copy

🌟 Tips

1. Use external keyboard for better productivity
2. Bluetooth mouse works great with Termux
3. Split screen for multitasking
4. Use sessions to organize work

🔗 Links

• GitHub Repository
• NPM Package
• Report Issues

📄 License

MIT © Zesbe

Made with ❤️ for Termux users! 🤖