Skip to content

Bierchermuesli/albert-macaddr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Albert MAC-hwaddr Lookup Module

This is a sipmle query modul for awsome Albert Launcher. It resolves and re-formats any kind of ethernet Hardware Address (OUI)

Synopsis: mac {##:##:##[:##:##:##]|##-##-##[-##-##-##]|######[######]}

Default Trigger: mac [any kind of hw addr]

Background details: The plugin ships a prebuilt oui.json (parsed from the IEEE OUI list at https://standards-oui.ieee.org/oui/oui.txt) and loads it at startup. The plugin itself never hits the network for OUI data — works fully offline.

OUI assignments are append-only and stable, so a bundled DB stays useful for years. To refresh, run the standalone build-oui.py in the plugin directory:

python3 build-oui.py            # writes oui.json next to the script
python3 build-oui.py --out /tmp/oui.json

For OUIs missing from the bundle, an optional macvendors.com API fallback is available (toggle in plugin settings). Successful API lookups are cached for the session.

Installation

Simple clone to Albert plugin directory and activate in Albert Python Modules Settings. No special python modules are required.

git clone https://github.com/Bierchermuesli/albert-macaddr.git ~/.local/share/albert/python/plugins/macaddr

OUI data © IEEE, redistributed as a parsed JSON snapshot.

Bugs / Feedback

always welcome, just some ad hoc coding

About

Albert Launcher Plugin for MAC addr Loookups

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages