#icons #freedesktop #lookup

freedesktop-icons

A Freedesktop Icons lookup crate

11 unstable releases (3 breaking)

0.4.0 Apr 16, 2025
0.3.1 Feb 8, 2025
0.3.0 Jan 23, 2025
0.2.6 Feb 13, 2024
0.2.1 May 24, 2022

#70 in GUI

Download history 26653/week @ 2025-01-08 25757/week @ 2025-01-15 24746/week @ 2025-01-22 28837/week @ 2025-01-29 30456/week @ 2025-02-05 24106/week @ 2025-02-12 30485/week @ 2025-02-19 29787/week @ 2025-02-26 24920/week @ 2025-03-05 28493/week @ 2025-03-12 34170/week @ 2025-03-19 30027/week @ 2025-03-26 25755/week @ 2025-04-02 33652/week @ 2025-04-09 23307/week @ 2025-04-16 23507/week @ 2025-04-23

113,052 downloads per month
Used in 8 crates

MIT license

37KB
804 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
~68K SLoC