FTTUI is a terminal-based user interface (TUI) for browsing projects from the FlavorTown Public API by jam06452. It allows users to explore hot, top (this week), top (all time) and random projects right into your shell!

• Browse Hot projects, Top this week, Top all time, and Random projects in a 4-panel TUI layout.
• View project details, including description, repo URL, demo URL, and ship status.
• Automatic refresh from the API with configurable interval.
• Cross-platform: works on Linux and Windows terminals.

FTTUI is designed for the optimisation sidequest and makes it fun and easy to explore projects you would otherwise had never seen.

It’s perfect for:

• Quickly checking trending projects.
• Find new projects to take a look at

1. Download the appropriate binary or .exe for your system from the releases.
2. Run it directly from the terminal (or you double click it if you are on windows):

./fttui      # Linux
fttui.exe     # Windows

Make sure you have Rust installed. Then:

git clone https://github.com/QKing-Official/FTTUI

cd FTTUI
cargo build --releasee

The compiled binary will be in the target folder.

A configuration file is automatically created at:

~/.config/fttui/config.json

Default configuration:

{
   "refresh_seconds": 30
}}

We checked memory while FTTUI ran in the background using ps:

PID     RSS     VSZ    COMMAND  
73689   4256    2105004 fttui    # first run, cold cache  
73906   4300    2105004 fttui    # second run, cached  

• First run (cold cache) → lots of HTTPS requests to fetch stuff.
• Second run (warm cache) → just a few requests, showing cache is working.
• Packets captured: 11 packets on cached run vs many more on first run.

We measured how long it takes with time:

# First run (cold cache)  
real    0m0.793s  



# Second run (warm cache)  
real    0m0.319s   

Cached runs are much faster. Release build makes it even quicker.

This project is licensed under MIT Feel free to contribute!!