#icons #freedesktop

freedesktop-icons

A Freedesktop Icons lookup crate

10 releases

0.3.1 Feb 8, 2025
0.2.6 Feb 13, 2024
0.2.4 Sep 21, 2023
0.2.3 Jan 11, 2023
0.2.1 May 24, 2022

#84 in GUI

Download history 25365/week @ 2024-11-18 12989/week @ 2024-11-25 22031/week @ 2024-12-02 19960/week @ 2024-12-09 21906/week @ 2024-12-16 4821/week @ 2024-12-23 7054/week @ 2024-12-30 23903/week @ 2025-01-06 30140/week @ 2025-01-13 20933/week @ 2025-01-20 27253/week @ 2025-01-27 30783/week @ 2025-02-03 30300/week @ 2025-02-10 24779/week @ 2025-02-17 28894/week @ 2025-02-24 25660/week @ 2025-03-03

110,002 downloads per month
Used in 7 crates

MIT license

37KB
802 lines

freedesktop-icons

crates.io-badge docrs-badge

This crate provides a freedesktop icon lookup implementation.

It exposes a single lookup function to find icons based on their name, theme, size and scale.

Example

Simple lookup:

The following snippet get an icon from the default 'hicolor' theme with the default scale (1) and the default size (24).

use freedesktop_icons::lookup;

let icon = lookup("firefox").find();

Complex lookup:

If you have specific requirements for your lookup you can use the provided builder functions:

use freedesktop_icons::lookup;

let icon = lookup("firefox")
    .with_size(48)
    .with_scale(2)
    .with_theme("Arc")
    .find();

Cache:

If your application is going to repeat the same icon lookups multiple times you can use the internal cache to improve performance.

use freedesktop_icons::lookup;

let icon = lookup("firefox")
    .with_size(48)
    .with_scale(2)
    .with_theme("Arc")
    .with_cache()
    .find();

Dependencies

~0.7–11MB
~69K SLoC