Ricoh Supply CLI

Ricoh Supply CLI is a "blazingly fast 🤣" Python CLI tool that allows checking Ricoh printer's supply/toner status with SNMP protocol.

Windows is not supported

Warning - Windows installation is failing

I tested in Windows 11 with Python 3.11.1, and it's failing. I think easysnmp doesn't have proper Windows support.

✖ Install easysnmp 0.2.6 failed

📦 Installation

Cloning the repo

git clone https://github.com/angelside/ricoh-supply-cli-py.git ricoh-supply-cli-py

cd ricoh-supply-cli-py

Use the package manager pdm to install. Run the below command inside the project directory.

pdm install

🔨 Usage

CLI app has only one parameter and that is the IP address of the printer.

python main.py 172.10.0.2

or

chmod +x main.py
./main.py 172.10.0.2

📋 Sample results

CMYK

> ./main.py 172.10.0.2
ip: 172.10.0.2 - model: MP C307 - serial: 11111111111

[====================================----] 90.0%  black
[============----------------------------] 30.0%  cyan
[============----------------------------] 30.0%  magenta
[========--------------------------------] 20.0%  yellow

only black

./main.py 172.10.0.3
ip: 172.10.0.3 - model: P 502 - serial: 22222222222

[============================------------] 70.0%  black

💥 Features

• Retrieves; model, serial, toner level status
• Progress bar
• Ip address validation
• SNMP exceptions

🎯 Tested Ricoh printer models

• IM C300 (cmyk)
• IM C3500 (cmyk)
• MP C307 (cmyk)
• P 502 (black)

🤝 Contributing

Before contributing issues or pull requests, could you review the Contributing Guidelines first?

💬 Questions?

Feel free to open an issue.

🤩 Support

💙 If you like this project, give it a ⭐ and share it with friends!

🏛️ License

This project is open-sourced software licensed under the MIT license.