Rofi-Chem - Chemical Elements & Compounds Rofi Plugin

A Rofi mode plugin for quick lookup of periodic table elements and chemical compounds with data from NIST, Mendeleev, and PubChem.

Features

• Interactive periodic table lookup integrated with Rofi.
• Instant access to element properties (atomic number, mass, density, etc.).
• Chemical compound information (formula, experimental properties like melting/boiling point, molecular weight).
• Configurable display fields.
• Fuzzy search by name, symbol, or formula.
• Local SQLite cache for fast offline access.

🛡 Security & CI/CD

This project uses robust automation to ensure quality:

• Build Verification: Automatically tests builds on every push.
• CodeQL: Advanced security scanning for Go vulnerabilities.
• Dependabot: Automated dependency updates.

Installation

Option 1: Direct Binary (Recommended)

Download the latest rofi-chem binary from the Releases page and place it in your $PATH (e.g., ~/.local/bin/).

Option 2: Build from Source

git clone https://github.com/fam007e/rofi-chem.git
cd rofi-chem
go build -o rofi-chem cmd/rofi-chem/main.go
mv rofi-chem ~/.local/bin/

Note

No database setup is required. The element data is embedded inside the binary and will be automatically extracted on first run.

Data & Contributions

This branch (main) focuses on the Rofi interface and Go core.

• To add new compounds: Please switch to the data branch, which contains the specialized Python pipeline for data enrichment.
• To contribute: See CONTRIBUTING.md for details on our dual-branch strategy.

Usage

rofi -modi "chem:rofi-chem" -show chem

Configuration

Configuration is stored in ~/.config/rofi/rofi-chem/config.yaml.

Data Sources

This project aggregates scientific data from the following reputable sources:

• Mendeleev: For comprehensive periodic table properties.
• PubChem: For molecular information and chemical compound properties.
• NIST: For atomic weights and isotopic compositions.

License

This project is licensed under the MIT License.