giovannicoppola / alfred-ICDbrowser

A browser for ICD codes

alfred-ICD 🔟 browser

An Alfred browser for ICD-10 codes

• Motivation
• Setting up
• Basic Usage
• Known Issues
• Acknowledgments
• Changelog
• Feedback

Motivation ✅

• To search or browse ICD-10 codes without opening a browser/website
• to review and learn about the ICD-code hierarchy

Setting up ⚙️

Needed

• Alfred 5 with Powerpack license
• pandas library (can be installed with pip3 install pandas)

Basic Usage 📖

Browsing 📇

• launch with keyword (default: icd-b) or custom hotkey.
• a search term (optional, multiple strings supported) will filter the entries at the current level.
• Browse across categories:
  • Enter: forward
  • Cmd-Enter: back
• Shift-enter will show the corresponding entry in large font and copy it to the clipboard
• option-enter will show the complete current list in large font and copy it to the clipboard
• Ctrl-enter will show the corresponding entry within the ICD hierarchy (current item will be marked with ✴️)

Searching 🔍

• adding --a to the search string (multiple strings supported) will search across the entire ICD-10 database.
• Ctrl-enter will show the corresponding entry within the ICD hierarchy (current item will be marked with ✴️)
• Shift-enter will show the corresponding entry in large font and copy it to the clipboard

Showing entry within the ICD hierarchy 🌲

• Ctrl-enter will show the corresponding entry within the ICD hierarchy (current item will be marked with ✴️)
• Shift-enter will show the hierarchy in large font and copy it to the clipboard

rebuilding database (optional) 🛠️

• alfred-ICDbrowser comes with the database derived from the ICD XML tabular file released on April 1 2023 and available on the CDC website here
• the script icd-fun.py can be used to rebuild/update the database. Run with python3 icd-fun.py "path-to-XML-file.xml"

Limitations & known issues ⚠️

• None for now, but I have not done extensive testing, let me know if you see anything!

Acknowledgments 😀

• Icons from Flaticon

Changelog 🧰

• 2023-06-14: version 0.2 (added option to copy entire output
• 2023-05-11: version 0.1

Feedback 🧐

Feedback welcome! If you notice a bug, or have ideas for new features, please feel free to get in touch either here, or on the Alfred forum.