#console #terminal #cli

bin+lib termbg

Terminal background color detection

11 releases

0.4.3 Mar 2, 2023
0.4.2 Mar 2, 2023
0.4.1 May 25, 2022
0.4.0 Jan 25, 2022
0.1.0 Nov 9, 2020

#1544 in Command line utilities

Download history 394/week @ 2023-08-02 324/week @ 2023-08-09 554/week @ 2023-08-16 1026/week @ 2023-08-23 488/week @ 2023-08-30 519/week @ 2023-09-06 516/week @ 2023-09-13 491/week @ 2023-09-20 413/week @ 2023-09-27 1033/week @ 2023-10-04 805/week @ 2023-10-11 803/week @ 2023-10-18 440/week @ 2023-10-25 572/week @ 2023-11-01 408/week @ 2023-11-08 510/week @ 2023-11-15

2,030 downloads per month
Used in 3 crates

MIT/Apache

18KB
358 lines

termbg

A Rust library for terminal background color detection. The detected color is provided by RGB or theme ( dark or light ).

Actions Status Crates.io Docs.rs

Verified terminals

If you check other terminals, please report through issue.

Unsupported terminals

"Windows Terminal" may be supported in a future release: https://github.com/microsoft/terminal/issues/3718.

Usage

[dependencies]
termbg = "0.4.3"

Example

fn main() {
    let timeout = std::time::Duration::from_millis(100);

    println!("Check terminal background color");
    let term = termbg::terminal();
    let rgb = termbg::rgb(timeout);
    let theme = termbg::theme(timeout);

    println!("  Term : {:?}", term);

    match rgb {
        Ok(rgb) => {
            println!("  Color: R={:x}, G={:x}, B={:x}", rgb.r, rgb.g, rgb.b);
        }
        Err(e) => {
            println!("  Color: detection failed {:?}", e);
        }
    }

    match theme {
        Ok(theme) => {
            println!("  Theme: {:?}", theme);
        }
        Err(e) => {
            println!("  Theme: detection failed {:?}", e);
        }
    }
}

Check program

This crate provides a simple program to check.

$ cargo run
Check terminal background color
  Term : Tmux
  Color: R=0, G=0, B=0
  Theme: Dark

Detecting mechanism

If the terminal is win32 console, WIN32API is used for detection. If the terminal is xterm compatible, "Xterm Control Sequences" is used. When these method was failed, COLORFGBG environment variable is used.

The detected RGB is converted to YCbCr. If Y > 0.5, the theme is detected as "light", otherwise "dark".

Dependencies

~2–12MB
~148K SLoC