clicknick 0.5.5

Context-aware nickname autocomplete for ClickPLC instruction windows.

clicknick

Context-aware nickname autocomplete for ClickPLC instruction windows.

Features

• Smart Autocomplete: Shows only relevant nicknames based on instruction type
• Multiple Filter Modes: Prefix, Contains, and Fuzzy matching
• Exclude: SC/SD addresses or your own
• Non-Intrusive: Works alongside Click PLC without modifications

How to Run

[!NOTE] For live nickname database functionality, you'll need Microsoft Access ODBC drivers installed. If you see an "ODBC drivers not found" warning, see our installation guide for help. CSV nickname file loading works without these drivers.

Option 1: Using uv (recommended)

uvx clicknick

If you don't have uv installed, you can get it from: https://github.com/astral-sh/uv#installation

To upgrade to the latest version:

uvx clicknick@latest

Option 2: Using pip

pip install clicknick
python -m clicknick

Usage

1. Select your ClickPLC nickname CSV file
2. Connect to your Click PLC instance
3. Start monitoring
4. Open ClickPLC Instruction window and Type in added Combobox-Input to see autocomplete suggestions

Supported Windows

• Contact Normally Open/Closed
• Edge Contact
• Out, Set, Reset
• Compare (A with B)
• Timer, Counter
• Math instructions
• Shift Register
• Copy instruction
• Search instruction
• Search & Replace dialog

Requirements

• Windows 10/11
• Click PLC Software

Roadmap

• Add support for inserting Nickname/Address into Math equation

---

Project Docs

For how to install uv and Python, see installation.md.

For development workflows, see development.md.

For instructions on publishing to PyPI, see publishing.md.

---

This project was built from simple-modern-uv.