4 releases (2 breaking)
Uses new Rust 2024
new 0.3.0 | Mar 11, 2025 |
---|---|
0.2.1 | Feb 1, 2025 |
0.1.1 | Sep 15, 2024 |
0.1.0 | Sep 7, 2024 |
#320 in Images
122 downloads per month
Used in applications
27KB
587 lines
Windows Icons
A simple Rust library to extract icons from files and running processes on Windows platforms.
Features
- Retrieve icons by file path or process id
- Save as a PNG or base64 encoded string
Installation
Add to your Cargo.toml
:
[dependencies]
windows-icons = "0.2.1"
Usage
// Get icon as an image from a file path
let icon = get_icon_image_by_path("C:\\Windows\\System32\\notepad.exe").unwrap();
icon.save("notepad.png").unwrap();
// Get icon as a base64 string from a file path
let base64 = get_icon_base64_by_path("C:\\Windows\\System32\\calc.exe").unwrap();
println!("Calculator icon: {}", base64);
// Get icon as an image from dll
let folder = DllIcon::new().with_shell32(5);
let icon = get_icon_by_dll(folder).unwrap();
icon.save("output/folder.png").unwrap();
// Get icon as a base64 string frome dll
let explorer = DllIcon::new().with_explorer(1);
let base64 = get_icon_base64_by_dll(explorer).unwrap();
println!("Explorer: {}", base64);
// Get icon as an image from a process ID
let process_id = 1234;
let icon = get_icon_image_by_process_id(process_id).unwrap();
icon.save("process.png").unwrap();
// Get icon as a base64 encoded string from a process ID
let base64 = get_icon_base64_by_process_id(process_id).unwrap();
println!("Process {} icon: {}", process_id, base64);
For more examples, check the examples
.
Cargo run --example icon
Cargo run --example process
Cargo run --example dll
Requirements
This library is designed to work on Windows systems only.
License
This project is licensed under the MIT License - see the LICENSE
for details.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Acknowledgements
This library uses the following crates:
image
for image processingbase64
for base64 encodingglob
for matching file pathswindows
for Windows API interactions
Disclaimer
This library uses unsafe Rust code to interact with the Windows API. While efforts have been made to ensure safety, use it at your own risk.
Dependencies
~119MB
~2M SLoC