https://github.com/ashishjii/erpsnap
ErpSnap ⚡ is a lightweight and efficient widget app that provides seamless access to PSIT ERP data. With real-time updates 📊 fetched via API calls, it runs quietly in the background, auto-starts on Windows, and offers smooth login handling 🔑. Built with Python, it’s optimized for performance, minimal dependencies, and a user-friendly
https://github.com/ashishjii/erpsnap
hacktoberfest python rest-api
Last synced: 8 months ago
JSON representation
ErpSnap ⚡ is a lightweight and efficient widget app that provides seamless access to PSIT ERP data. With real-time updates 📊 fetched via API calls, it runs quietly in the background, auto-starts on Windows, and offers smooth login handling 🔑. Built with Python, it’s optimized for performance, minimal dependencies, and a user-friendly
- Host: GitHub
- URL: https://github.com/ashishjii/erpsnap
- Owner: AshishJii
- License: apache-2.0
- Created: 2024-04-24T12:24:06.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-11-21T11:21:51.000Z (over 1 year ago)
- Last Synced: 2025-05-30T08:50:31.860Z (about 1 year ago)
- Topics: hacktoberfest, python, rest-api
- Language: Python
- Homepage:
- Size: 3.55 MB
- Stars: 8
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ErpSnap
A widget application that provides a one-click interface to view the latest info from PSIT ERP. It saves time by directly fetching data from APIs, allowing users to quickly access the information they need.
## Installation FAQ
How to install ErpSnap?
1. Download the [latest release](https://github.com/ashishjii/ErpSnap/releases/latest) and install it.
3. After installation, find ErpSnap in the Start menu or use the desktop shortcut.
4. On initial launch, click the refresh button in the top-right corner to input credentials.
I'm seeing a Windows Defender SmartScreen warning. What should I do?
If you encounter a Windows Defender SmartScreen warning, click on "More info" and then click "Run anyway". This warning appears because the program is not digitally signed with an **Extended Validation (EV) code signing certificate**, which costs around $300-$800. Rest assured, ErpSnap is not a virus.
How do I exit the app?
To exit the application, click on the info button located at the top right corner of the screen, then click "Exit application".
I entered my username and details incorrectly. What should I do?
If you've entered your username and/or details incorrectly, you can reset them by deleting the credentials file located at `%AppData%/ErpSnap`. To do this, open your file manager and copy-paste the provided location into the address bar. After deleting the file, restart the application, and you will be prompted to enter your credentials again.
## Features
| Feature | Status |
|-|-|
| Draggable widget | ✔️ |
| Does not appear in taskbar | ✔️ |
| Installation file created | ✔️ |
| Autostarts on Windows boot | ✔️ |
| Prompt for roll/pass on initial run | ✔️ |
| Move request call to dedicated worker thread | ✔️ |
| Provide progress indicators for logging and data retrieval | ✔️ |
| Start widget on the right side | ✔️ |
| Retrieve absent days and notices(HTML parsing) | ⏳80% |
| Check internet connectivity/slow internet | ✔️ |
| Implement loading animation | ✔️ |
| Add option to exit | ✔️ |
| Show last synced time | |
| Auto-sync data on startup if info exists | ✔️ |
| Open dashboard from app directly | ✔️ |
| Check if login info is incorrect | |
| Add option to re-enter info | |
>[!NOTE]
>Consider using `urllib3` instead of `requests` library to reduce third-party dependency requirements.
## Contributing
Contribution Guidelines
1. Clone the repository:
```bash
git clone https://github.com/AshishJii/ErpSnap.git
```
2. Install dependencies:
```bash
pip install -r requirements.txt
```
3. Run the application:
```bash
python main.py
```
4. Convert to exe file:
```bash
pyinstaller --noconfirm --onefile --windowed --icon "assets/logo.ico" --name "ErpSnap" --add-data "assets;assets/" "main.py"
```
#### How to Contribute
- Fork the repository.
- Make your changes in a feature branch.
- Submit a pull request with your changes.
## License
This project is licensed under the Apache-2.0 License - see the [LICENSE](LICENSE) file for details.