English | 日本語 | 中文 | Español | Français
A fast and simple SD card photo selection tool for photographers
Cap.2025-03-05.at.21.10.00.mp4
- Simple Interface - Intuitive operation in your terminal
- Fast Preview - Smooth browsing experience with background image preloading
- Exposure Adjustment - Adjust image brightness on the fly
- RAW Support - Automatic tagging and processing of DNG (RAW) files
- P3 Color Space - Enhanced color display on supported screens
- Efficient Workflow - Quickly select favorite photos with the "Like" feature
- macOS
- iTerm2
- imgcat (iTerm2's image display command)
# Clone the repository
git clone https://github.com/yahirrro/toricomi.git
cd toricomi
# Make the script executable
chmod +x image_selector.sh
# Run the script
./image_selector.shFor a better experience, we recommend installing the following tools:
# Install ImageMagick for high-quality exposure adjustments
brew install imagemagick
# Install a DNG processing tool (choose one)
brew install darktable # recommended
# or
brew install rawtherapee
# or
brew install dcraw-
Connect your SD card to your Mac
-
Run the script
# Run with default language (Japanese) ./image_selector.sh # Run with English interface ./image_selector.sh -l en # or ./image_selector.sh --lang en
-
Follow the on-screen instructions
- Select your SD card
- Choose a date (or "All")
- Browse and select photos
| Key | Function |
|---|---|
| ↑/↓ | Navigate to previous/next photo |
| ←/→ | Adjust exposure (darker/brighter) |
| Enter | Mark photo as "Like" |
| q | Quit |
The script supports multiple languages:
- Japanese (default)
- English
You can specify the language using the -l or --lang option:
# Run with English interface
./image_selector.sh -l enThe system automatically loads language files from the lang/ directory.
When photos are too dark or too bright, you can adjust the exposure using the ←/→ keys. Better quality adjustments are available if ImageMagick is installed.
If a DNG file exists corresponding to a JPEG file, it will automatically be tagged when you mark the JPEG as "Like". At the end of the script, you can move tagged DNG files to a specified folder.
If you have a P3 color space compatible display, you can enjoy more vibrant color display.
You can customize the following parameters in the script:
# Display settings
TITLE_BAR_HEIGHT=30 # Title bar height in pixels
LINE_HEIGHT_PX=18 # Line height in pixels
MAX_IMG_WIDTH=2000 # Maximum image width in pixels
# Display scale
SIZE_FACTOR=2 # Display size factor (1.0=original, 1.2=20% larger)
# Exposure adjustment settings
EXPOSURE_STEP=2 # Exposure adjustment step
MAX_EXPOSURE=25 # Maximum exposure value
MIN_EXPOSURE=-25 # Minimum exposure value
# DNG processing settings
USE_DNG_FOR_EXPOSURE=1 # Use DNG files for exposure adjustment (1=enabled, 0=disabled)toricomi supports multiple languages. You can set your preferred language by setting the TORICOMI_LANG environment variable:
# Set language to English
export TORICOMI_LANG=en
# Set language to Japanese
export TORICOMI_LANG=ja
# Set language to Chinese
export TORICOMI_LANG=zh
# Set language to Spanish
export TORICOMI_LANG=es
# Set language to French
export TORICOMI_LANG=frIf no language is specified, English will be used as the default.
| Issue | Solution |
|---|---|
| "iTerm2 or imgcat command is not available" | Make sure iTerm2 is installed and up to date |
| Images appear too small | Increase the SIZE_FACTOR in the script |
| DNG files are not processed | Install darktable, rawtherapee, or dcraw |
| Terminal size error | Increase your terminal window size (at least 24x80) |
- Library mode (view photos from multiple SD cards at once)
- Keyword tagging feature
- Extended metadata display (shooting settings, camera information, etc.)
- Multiple display support
Contributions are welcome! Feel free to submit bug reports, feature requests, or pull requests.
- Yahiro Nakamoto (@yahirrro)
Released under the MIT License. See the LICENSE file for details.
Made with ❤️ for photographers