|
|
# Mail Checker
|
|
|
|
|
|
**Mail Checker** je napredna i potpuno funkcionalna Python aplikacija koja radi unutar sistemske trake (*System Tray*) i služi za praćenje nepročitanih poruka s više IMAP računa istovremeno.
|
|
|
|
|
|
Aplikacija podržava:
|
|
|
- zvučne obavijesti
|
|
|
- glasovna upozorenja na hrvatskom jeziku (TTS)
|
|
|
- pregled i čitanje zadnjih poruka kroz tabove
|
|
|
- sigurno pohranjivanje lozinki
|
|
|
|
|
|
> **Napomena o kompatibilnosti:**
|
|
|
> Ova aplikacija razvijena je isključivo za **Linux** sustave te je službeno testirana i optimizirana na **Debian 13 (Trixie)** operativnom sustavu.
|
|
|
|
|
|
---
|
|
|
|
|
|
# ✨ Funkcionalnosti
|
|
|
|
|
|
- **Praćenje više računa**
|
|
|
Sinkronizirana provjera više e-mail računa s različitim IMAP poslužiteljima.
|
|
|
|
|
|
- **Fleksibilni intervali**
|
|
|
Svaki račun može imati vlastiti interval provjere (minimalno 10 sekundi).
|
|
|
|
|
|
- **Napredne obavijesti**
|
|
|
- Desktop notifikacije preko sistemskog daemon-a (`notify-send`)
|
|
|
- Prilagođene zvučne datoteke (`.wav`, `.mp3`) za svaki račun zasebno
|
|
|
- **Glasovni alert (TTS)**:
|
|
|
Izgovaranje broja nepročitanih poruka na hrvatskom jeziku uz ispravnu gramatičku deklinaciju:
|
|
|
- `1 poruku`
|
|
|
- `2 poruke`
|
|
|
- `5 poruka`
|
|
|
|
|
|
Podržan je izbor muškog ili ženskog glasa.
|
|
|
|
|
|
- **Pregled poruka**
|
|
|
Sučelje s tabovima unutar kojeg možete pročitati tekstualni sadržaj zadnjih poruka ili ih trajno obrisati (prebaciti u *Trash*).
|
|
|
|
|
|
- **Visoka sigurnost**
|
|
|
Integracija sa sistemskim privjeskom ključeva (`keyring`) – lozinke se ne zapisuju u plain-text obliku unutar konfiguracijske datoteke ako je privjesak dostupan.
|
|
|
|
|
|
- **Otpornost na mrežne greške**
|
|
|
Implementiran je *exponential backoff* mehanizam za ponovne pokušaje u slučaju gubitka mrežne veze.
|
|
|
|
|
|
---
|
|
|
|
|
|
# 🛠️ Potpuni zahtjevi i instalacija (Debian 13)
|
|
|
|
|
|
Kako bi aplikacija radila bez pogrešaka i upozorenja u terminalu, potrebno je instalirati sve sistemske biblioteke i Python pakete.
|
|
|
|
|
|
## 1. Instalacija sistemskih paketa (APT)
|
|
|
|
|
|
Otvorite terminal i pokrenite sljedeću naredbu:
|
|
|
|
|
|
```bash
|
|
|
sudo apt update
|
|
|
|
|
|
sudo apt install python3-tk python3-pil python3-pystray python3-keyring \
|
|
|
espeak-ng mpv \
|
|
|
libayatana-appindicator3-1 \
|
|
|
libayatana-appindicator-glib1 \
|
|
|
libnotify-bin \
|
|
|
gir1.2-gtop-2.0 \
|
|
|
dbus-x11
|
|
|
```
|
|
|
|
|
|
### Pojašnjenje paketa
|
|
|
|
|
|
- `python3-tk`
|
|
|
Omogućuje rad Tkinter grafičkog sučelja u Pythonu.
|
|
|
|
|
|
- `python3-pil`
|
|
|
Pillow biblioteka za generiranje i manipulaciju ikona u sistemskoj traci.
|
|
|
|
|
|
- `python3-pystray`
|
|
|
Omogućuje kreiranje i upravljanje ikonom u sistemskoj traci.
|
|
|
|
|
|
- `python3-keyring`
|
|
|
Omogućuje Pythonu komunikaciju sa sustavnim privjeskom ključeva za sigurno spremanje lozinki.
|
|
|
|
|
|
- `espeak-ng`
|
|
|
TTS pokretač koji generira glasovne obavijesti na hrvatskom jeziku.
|
|
|
|
|
|
- `mpv`
|
|
|
Media player koji aplikacija koristi za reprodukciju `.mp3` i `.wav` datoteka bez blokiranja sučelja.
|
|
|
|
|
|
- `libayatana-appindicator3-1`
|
|
|
- `libayatana-appindicator-glib1`
|
|
|
|
|
|
Sustavne biblioteke ključne za ispravan prikaz ikone u sistemskoj traci (*AppIndicator*).
|
|
|
|
|
|
- `libnotify-bin`
|
|
|
Omogućuje slanje desktop obavijesti putem naredbe `notify-send`.
|
|
|
|
|
|
- `dbus-x11`
|
|
|
Osigurava stabilnu komunikaciju aplikacije sa sistemskim servisima.
|
|
|
|
|
|
---
|
|
|
|
|
|
# 🚀 Pokretanje aplikacije
|
|
|
|
|
|
Aplikaciju pokrećete iz njezinog direktorija standardnom naredbom:
|
|
|
|
|
|
```bash
|
|
|
python3 mail_checker.py
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
# ⚙️ Korisničko sučelje (Postavke i pregled)
|
|
|
|
|
|
## Upravljanje računima
|
|
|
|
|
|
Prozor za postavke podijeljen je na dva dijela:
|
|
|
|
|
|
### Lijeva strana
|
|
|
- Popis registriranih računa
|
|
|
- Horizontalni klizač za dugačke adrese
|
|
|
- Gumbi `▲` / `▼` za promjenu redoslijeda provjere
|
|
|
|
|
|
### Desna strana
|
|
|
Formular za unos detalja računa:
|
|
|
- Nadimak
|
|
|
- IMAP server
|
|
|
- Email
|
|
|
- Lozinka
|
|
|
- Interval provjere
|
|
|
- Zvučna datoteka
|
|
|
- TTS postavke
|
|
|
- Opcije pregleda
|
|
|
|
|
|
---
|
|
|
|
|
|
## Pregled poruka
|
|
|
|
|
|
Klikom na **Pregled poruka** unutar izbornika sistemske trake otvara se prozor koji dohvaća najnovije poruke za sve račune koji imaju uključenu opciju prikaza.
|
|
|
|
|
|
Dvostrukim klikom na poruku otvara se prozor za čitanje tekstualnog sadržaja s opcijom izravnog brisanja poruke sa servera.
|
|
|
|
|
|
---
|
|
|
|
|
|
# 📁 Struktura datoteka
|
|
|
|
|
|
Aplikacija koristi i stvara sljedeće datoteke:
|
|
|
|
|
|
- `mail_checker.py`
|
|
|
Glavni izvorni kod aplikacije.
|
|
|
|
|
|
- `config.json`
|
|
|
Konfiguracijska datoteka u kojoj se čuvaju postavke računa.
|
|
|
|
|
|
- `mail_checker.log`
|
|
|
Detaljan dnevnik rada i pogrešaka (*log file*).
|
|
|
|
|
|
---
|
|
|
|
|
|
# 🔒 Sigurnost lozinki (Keyring Helper)
|
|
|
|
|
|
Aplikacija automatski prepoznaje podržava li vaše radno okruženje privjesak ključeva (*GNOME Keyring* ili *KDE Wallet*).
|
|
|
|
|
|
- **Ako je privjesak dostupan**
|
|
|
- Polje `"MAIL_PASSWORD"` unutar `config.json` ostat će prazno (`""`)
|
|
|
- Lozinka će biti sigurno pohranjena pod servisom `MailChecker`
|
|
|
|
|
|
- **Ako privjesak nije dostupan**
|
|
|
- Aplikacija zapisuje upozorenje u log
|
|
|
- Lozinka se sprema lokalno u `config.json` kako bi aplikacija mogla nastaviti raditi
|
|
|
|
|
|
---
|
|
|
|
|
|
# 🐛 Rješavanje problema i dnevnik rada (Logging)
|
|
|
|
|
|
Sve akcije, promjene stanja, uspješni dohvat poruka te IMAP ili mrežne pogreške zapisuju se u datoteku:
|
|
|
|
|
|
```bash
|
|
|
mail_checker.log
|
|
|
```
|
|
|
|
|
|
Praćenje loga u stvarnom vremenu:
|
|
|
|
|
|
```bash
|
|
|
tail -f mail_checker.log
|
|
|
```
|
