Overview

RAVEN Hub lives quietly in your Mac's menu bar. It watches which app you're actively working in — Final Cut Pro, the Adobe apps, Xcode, Office, iWork, Figma, Blender, DaVinci Resolve, or even a specific web app in your browser — and automatically starts and stops a timer for the matching project. No start/stop buttons, no forgotten timers.

Everything it tracks feeds directly into the rest of the app: projects roll up into jobs for a client, jobs roll up into invoices, and invoices can be exported as PDF, emailed, or generated as structured e‑invoice XML for countries that require it.

Installing & first launch

Before you open it the first time

First launch — onboarding

The first time you open RAVEN Hub, a short 4‑step setup window walks you through everything it needs:

1. Terms & Privacy

   Review and check the box agreeing to the License Terms and Privacy Policy. The Next → button stays disabled until this is checked — it's the only place in the app you'll be asked for this consent.

2. Accessibility access

   RAVEN Hub reads the active project's window title to know what you're working on, across every app it tracks — not just one. This step shows whether access is already granted, offers a button to open the system permission prompt directly, and updates automatically the moment you grant it in System Settings — no need to come back or restart the app.

3. Your hourly rate

   Set a default hourly rate used to calculate earnings. You can leave it at 0 and set it, or override it, per project later — this is just a starting default.

4. Where to find RAVEN Hub

   A quick heads‑up that RAVEN Hub lives in the menu bar rather than the Dock. After this step, the app automatically opens its menu‑bar popover once so you can see exactly where to click next time.

The final step's button reads Start instead of Next and takes you straight into the app. A 14‑day free trial starts automatically — no credit card, no account creation. RAVEN Hub also launches at login by default; this can be turned off any time in Settings → General.

Menu bar & global shortcut

RAVEN Hub's home base is a small timer icon in your Mac's menu bar — it has no Dock icon. Left‑click it any time to open the popover; click elsewhere to dismiss it. Right‑click it for a quick menu instead.

• Timer digits — while actively tracking, the elapsed time (h:mm:ss, or m:ss under an hour) is shown next to the icon, if enabled in Settings → General.
• Global shortcut — ⌘ ⇧ T — works system‑wide, even when RAVEN Hub isn't the active app. It opens the main window on the Projects tab and pops the menu‑bar summary open, so you can quickly pick a project and add time manually.

Right‑click menu

Right‑clicking the menu bar icon opens a short menu instead of the popover — handy if you just want to jump straight somewhere:

What's in the popover

From top to bottom, the popover shows:

• Welcome banner (first time only, shown automatically right after onboarding) — a quick "RAVEN Hub lives here" pointer confirming where to find the app; dismiss it with Got it and it won't show again.
• Permission banner (only if Accessibility and Screen Recording access are both missing) — a dismissible orange strip prompting you to grant access.
• Current status — one of three states: "Working" (orange, actively tracking), "Switched — timer still running" (yellow, inside the grace‑period window after switching apps), or a chip listing which tracked creative apps are currently open if none is being actively tracked.
• Active project — colored dot, project name, and a large monospaced elapsed‑time readout.
• Today's sessions — a scrollable list of everything tracked today, each row showing the project, its app badge, time range, and duration. Tap a row to add or edit a note on that session.
• Today's total — combined tracked time for the day.
• Open RAVEN Hub / Settings — quick actions at the bottom (Quit lives in the right‑click menu instead — see above).

Quick Note popup

When a session tracked purely by app (rather than by document — e.g. Canva or CapCut, where there's no real per‑file project name) ends, a small prompt appears: "What did you work on in {app}?" Type a quick note or skip it — this keeps app‑level time entries meaningful in your reports. This popup can be turned off in Settings → Tracking.

The main window

Opening RAVEN Hub's window (from the popover, the global shortcut, or the Dock while it's open) brings up a five‑tab workspace:

The window itself is resizable (minimum roughly 1350×680), and closing it doesn't quit RAVEN Hub — tracking keeps running in the background from the menu bar.

Motivation goal bar

A thin progress bar can be shown at the bottom of the window, tracking this calendar year's invoiced revenue against an annual target you set. Turn it on and set the target in Settings → General. It turns from blue to green — with a small glow — once the goal is reached, and switches its label to "✓ Goal reached +X · +Y%".

Projects

The Projects sidebar is where most day‑to‑day work happens. Projects are organized into jobs ("zákazky" internally) — a job groups every project belonging to one client or engagement, so you can see combined time and earnings without merging the underlying projects.

Sidebar toolbar

Each job appears as a colored, expandable folder with the app badges of everything tracked inside it, plus its combined time and earnings. Below the named jobs sits a resizable Standalone Projects panel for anything not assigned to a job — drag its top edge to resize.

Row actions

Swiping a project row reveals quick actions: delete and hide/show on the trailing edge, mark paid/unpaid on the leading edge. For the full set of options, right‑click.

Jobs — right‑click menu

Right‑clicking a job (the colored folder grouping a client's projects) opens:

Projects — right‑click menu

Right‑clicking an individual project row opens:

Creating a project

Most projects appear automatically the first time RAVEN Hub detects you working on them. You can also create one manually from the sidebar's + menu — useful for work that isn't tracked automatically, or to set up URL tracking for a web app in advance.

Manually created projects have no app badge in the sidebar (they weren't detected from a specific application).

Project detail view

Clicking into a project shows six cards, followed by notes, URL tracking, and the session list.

Notes

A free‑text notes field for TODOs, client instructions, or anything worth remembering about the project — click the pencil/plus icon to start editing.

URL tracking

Add or edit the text RAVEN Hub should look for in your browser's address bar to track time against this project (see Browser & URL tracking for how matching works). Click Add/Edit, type a substring like client.sk/wp-admin, save. Remove it the same way to disable web tracking for this project.

Sessions

Every tracked interval is listed with its time range, any note, and (for manual entries) a small label icon. Idle time over 60 seconds inside a session is shown separately from active time. Each row can be edited (start/end time, note, label) or deleted.

Add time manually

Use + Add time manually for work RAVEN Hub couldn't track automatically — a client call, offline work, or a session you forgot to let it catch. Fields: work description, date, start time, and end time (times roll over to the next day automatically if the end is earlier than the start). A live duration preview updates as you type.

App badges reference

Every tracked project carries a small colored badge showing which app produced it — the exact colors used in the app:

A project with no badge was created manually rather than detected from an application.

Automatic time tracking

RAVEN Hub recognizes the following applications out of the box. No configuration is needed — just work normally and a matching project appears.

How detection works

For each supported app, RAVEN Hub tries to work out which document or project you're actively in — not just that the app is open — using a layered approach:

1. Window title (needs Accessibility permission) — the most reliable source; RAVEN Hub parses the title per‑app (e.g. stripping "— Adobe Premiere Pro 2026" or workspace suffixes) to extract just the project name.
2. Screen Recording permission as a backup source for window titles, when Accessibility alone doesn't return one.
3. Open file handles — if no usable title is found, RAVEN Hub checks which project file the app currently has open (.prproj, .psd, .ai, .indd, .blend, .docx, .xlsx, .pages, and so on).
4. App name fallback — for cloud/web‑based tools with no local project file (Canva, CapCut), the app's own name is used as the "project," and you're prompted for a quick note when the session ends.

Generic or dialog window titles (things like "Open", "Save As", "Untitled", "Export") are filtered out in every supported UI language, so they never get tracked as a project by mistake.

Which app wins when several are open

If more than one tracked context is technically active, RAVEN Hub always prefers, in order: 1. a native creative/office app (Adobe, Office, iWork, Xcode, etc.) → 2. Final Cut Pro → 3. a matching browser URL. Browser tracking is only ever used when nothing else is currently active.

Browser & URL tracking

For web‑based work — a CMS, an ad platform, a client dashboard — RAVEN Hub can track time based on the current tab's URL, matched against a text pattern you set on a project (see URL tracking).

Matching is a simple, case‑insensitive substring check — if the pattern you set (e.g. client.sk/wp-admin) appears anywhere in the current tab's URL, tracking starts for that project. It isn't a strict domain match, so it also works for query‑string based routing.

The first time you use a given browser, macOS will show a one‑time permission dialog asking to allow RAVEN Hub to control it — this needs to be allowed for URL tracking to work.

Idle, grace period & session behavior

Sleep & crash recovery

Putting your Mac to sleep ends the current session cleanly. If RAVEN Hub or the tracked app ever quits unexpectedly mid‑session, the unfinished session is automatically closed off the next time RAVEN Hub launches, so you never end up with a session stuck "running" forever.

Untitled‑project reminder

If you're actively working in a document that's still called "Untitled" (or the equivalent in your app's language) for more than 20 seconds, RAVEN Hub shows a gentle reminder to name and save it, explaining why: RAVEN Hub only tracks time on named files, so without saving, that work won't be attributed to a project — recognized project names are far more useful in reports than a string of "Untitled‑1", "Untitled‑2"… This can be turned off in Settings → General → Notifications.

Clients

The Clients tab holds contact and invoicing details, kept separate from the projects themselves so one client can span multiple jobs.

Fields

Search matches name, company, or email. Sort by name (A–Z or Z–A), newest, or oldest. Toolbar toggles let you show/hide unpaid‑amount totals and hidden clients. Right‑click a client to hide or delete them.

Client detail

Opening a client shows summary cards (total time, total fee, paid, unpaid), the jobs currently assigned to them with per‑job time/earnings, their invoicing data block, and a prominent Issue Invoice button that opens a new invoice already filled in with this client's details.

Assigning jobs to a client

A client doesn't automatically "own" a job — you connect them explicitly. In the client's detail view, click Assign job next to the "Jobs" heading, then check off which existing jobs belong to this client (and uncheck to unassign — the job and its projects stay intact, only the link to the client is removed).

Seeing what's still unpaid

Each project listed under a client's job shows a green Paid pill once it's settled — a project with no pill is still unpaid — and the Unpaid summary card at the top of the client totals it up. This is the fastest way to see, per client, what still needs invoicing or chasing.

Invoicing

Document types

Creating an invoice

Start from the + button in the Invoices toolbar, or from a client's Issue Invoice button. Key fields:

Per‑line VAT

Each line item can carry its own VAT rate, overriding the invoice‑level default — useful when a single invoice mixes standard‑rate and reduced‑rate or zero‑rate items. Both the on‑screen totals and the PDF automatically break the VAT down by each distinct rate in use.

Numbering formats

Choose how invoice numbers are generated in Settings → Invoicing. Each document type (Invoice / Proforma / Quote / Credit note) keeps its own prefix and running counter.

Actions menu (on an open invoice)

Below Actions: Mark as paid, Edit, Email, and an Export button — a plain "PDF" button if no e‑invoice format is configured, or a menu offering Save PDF only, Export e‑invoice, and Send by email once one is. Every invoice keeps a send/reminder history log showing who was emailed and when.

Bulk export

The export icon in the Invoices toolbar opens a bulk‑export sheet: pick a date range (with quick buttons for this month / this year / last year), filter by document type and paid status, and export every matching invoice as one PDF each into a folder of your choice.

e‑Invoice formats

Several countries now require invoices in a structured XML format, not just a PDF. RAVEN Hub can generate the correct file for you — you're responsible for sending or uploading it, since RAVEN Hub does not integrate with any government portal directly. Set your format once in Settings → Invoicing.

PDF layout & QR code

Every generated PDF follows the same A4 layout: your logo top‑left, the document type and number top‑right, a three‑column block (seller / buyer / dates & payment), the line‑items table with automatic pagination for long invoices, totals with a per‑rate VAT breakdown, notes, a signature line with your uploaded stamp if set, and a colored payment strip across the bottom with the bank account, variable symbol, due date and amount.

If Show payment QR is enabled, an IBAN is set, and the invoice currency is EUR, a scannable SEPA/EPC payment QR code is added — compatible with SK/CZ/EU banking apps, pre‑filled with the payee, IBAN, amount and reference.

All of this — company name, logo, address, IBAN, accent color, and whether the QR appears at all — is configured once in Settings → Invoicing and reused on every document.

Sending invoices by email

RAVEN Hub can email invoices and reminders directly, using your own SMTP account (configured once in Settings → Email) — nothing goes through a third‑party mail relay.

The send sheet pre‑fills the recipient from the client record, an auto‑generated subject and body (with a quick option to CC yourself), and attaches the invoice as {number}.pdf. If SMTP isn't configured yet, the sheet shows a warning pointing you to Settings instead of failing silently.

Calendar

A month grid where each day is shaded by how many hours you logged that day (four intensity levels, from under 30 minutes to over 5 hours), with the hour total printed on the tile. A search field dims out days that don't match a project name, so you can spot a specific client's activity at a glance.

Selecting a day opens a detail panel on the right: total active time, then sessions grouped first by job and then by project within it, each level collapsible down to individual time ranges. A footer button exports just that day's activity as a PDF or CSV.

Reports & export

Four report modes, each with a date‑range switch (7 days / month / year / custom range):

Exporting

Available from Reports, from a job's context menu, and from the Calendar's day panel. Choose a payment filter (all / unpaid / paid) and an aggregation: Detailed (one row per session), Daily, Weekly, or Total summary (one row per project). Export as PDF (respecting your time‑rounding setting) or CSV.

Settings

Six tabs, opened from the RAVEN Hub menu (⌘,) or from About in the app.

Licensing & pricing

Every install starts with a 14‑day free trial — the full app, no feature limits, no credit card required. The trial clock is stored securely and survives reinstalling the app.

Activating a license

Paste your license key into the Have a license key? field in Settings → About (or on the trial‑expired screen) and click Activate. Each key is tied to one Mac at a time.

Moving to a new Mac

Click Deactivate device on your current Mac first — this frees the license so it can be activated on another machine.

Managing your subscription

Manage subscription opens your Lemon Squeezy customer portal in the browser, where you can update payment details, change plans, or cancel.

Backups & data safety

All of your data lives locally on your Mac — RAVEN Hub keeps automatic backups on top of that, with no setup required.

• Backs up to iCloud Drive when available (safe even if the Mac itself is lost or damaged), otherwise to ~/Documents, or to a folder you choose.
• Runs automatically 90 seconds after launch, every 8 hours after that (configurable), and again shortly after any data change — plus a dedicated backup right before installing an update.
• Regular backups are kept for 2 months; a backup taken just before an app update is kept indefinitely.
• Restoring picks a snapshot from a list and restarts the app to apply it.

Languages & currencies

Interface & invoice languages (11)

Slovak, English (UK), English (US/CA), German, Czech, French, Spanish, Italian, Japanese, Portuguese (Brazil), Russian. Change the app's own interface language in Settings → General; each individual invoice can additionally use a different document language than the interface.

Currencies (15)

EUR, USD, GBP, CZK, CHF, JPY, CAD, AUD, PLN, HUF, SEK, NOK, DKK, BRL, RUB — set in Settings → Invoicing, with the symbol shown before or after the amount, your choice.

Keyboard shortcuts

Support

Questions, feedback, or something not working as expected — reach out any time at dev@kanda.sk or visit www.ravenhub.sk. RAVEN Hub checks for updates automatically and can also be checked manually any time from Settings → About → Check for Updates.

Prehľad

RAVEN Hub žije nenápadne v menu bare tvojho Macu. Sleduje, v ktorej appke práve aktívne pracuješ — Final Cut Pro, Adobe appky, Xcode, Office, iWork, Figma, Blender, DaVinci Resolve, alebo aj konkrétnu web appku v prehliadači — a automaticky spúšťa a zastavuje časovač pre príslušný projekt. Žiadne tlačidlá štart/stop, žiadne zabudnuté časovače.

Všetko, čo sleduje, sa priamo prepája so zvyškom appky: projekty sa zoskupujú do zákaziek pre klienta, zákazky sa premietajú do faktúr, a faktúry sa dajú exportovať ako PDF, poslať e-mailom, alebo vygenerovať ako štruktúrovaná e-Faktúra XML pre krajiny, ktoré to vyžadujú.

Inštalácia a prvé spustenie

Predtým, než ju prvýkrát spustíš

Prvé spustenie — onboarding

Pri prvom spustení ťa krátke 4-krokové okno prevedie všetkým, čo appka potrebuje:

1. Podmienky a súkromie

   Prezri si a zaškrtni súhlas s Licenčnými podmienkami a Zásadami ochrany osobných údajov. Tlačidlo Ďalej → zostáva neaktívne, kým to nezaškrtneš — je to jediné miesto v appke, kde sa ťa na tento súhlas opýta.

2. Prístup k Accessibility

   RAVEN Hub číta názov aktívneho projektu z titulku okna, aby vedel čo práve robíš — naprieč každou appkou, ktorú sleduje, nielen jednou. Tento krok ukáže, či je prístup už udelený, ponúkne tlačidlo na priame otvorenie systémového promptu, a automaticky sa aktualizuje presne vo chvíli, keď prístup udelíš v Nastaveniach systému — netreba sa vracať ani appku reštartovať.

3. Hodinová sadzba

   Nastav si predvolenú hodinovú sadzbu pre výpočet honoráru. Môžeš ju nechať na 0 a nastaviť neskôr, alebo ju pre jednotlivé projekty prepísať — toto je len východiskový predvoľba.

4. Kde nájdeš RAVEN Hub

   Rýchle upozornenie, že RAVEN Hub žije v menu bare, nie v Docku. Po tomto kroku appka automaticky raz otvorí svoj menu bar popover, nech presne vidíš, kam nabudúce kliknúť.

Tlačidlo posledného kroku hovorí Spustiť namiesto Ďalej a vezme ťa rovno do appky. 14-dňový bezplatný trial sa spustí automaticky — bez platobnej karty, bez zakladania účtu. RAVEN Hub sa tiež predvolene spúšťa pri štarte systému; kedykoľvek to môžeš vypnúť v Nastavenia → Všeobecné.

Menu bar a globálna skratka

Domov RAVEN Hubu je malá ikonka časovača v menu bare tvojho Macu — nemá ikonu v Docku. Ľavým klikom ju kedykoľvek otvoríš (popover), klikom mimo ju zavrieš. Pravým klikom namiesto toho otvoríš rýchle menu.

• Číslice časovača — počas aktívneho sledovania sa vedľa ikonky zobrazuje uplynulý čas (h:mm:ss, alebo m:ss pod hodinu), ak je zapnuté v Nastavenia → Všeobecné.
• Globálna skratka — ⌘ ⇧ T — funguje odkiaľkoľvek v systéme, aj keď RAVEN Hub nie je aktívna appka. Otvorí hlavné okno na karte Projekty a vysunie menu-bar prehľad, nech rýchlo vyberieš projekt a pridáš čas ručne.

Menu pri pravom kliku

Pravý klik na ikonku v menu bare otvorí krátke menu namiesto popoveru — hodí sa, keď chceš ísť rovno niekam konkrétne:

Čo je v popoveri

Zhora nadol popover zobrazuje:

• Uvítací banner (len prvýkrát, appka ho automaticky ukáže hneď po onboardingu) — rýchly ukazovateľ "RAVEN Hub býva tu" potvrdzujúci kde appku nájdeš; zavri ho cez Rozumiem a už sa znova nezobrazí.
• Banner s oprávnením (len ak chýba Accessibility aj Screen Recording súčasne) — zatvárateľný oranžový pás vyzývajúci na udelenie prístupu.
• Aktuálny stav — jeden z troch stavov: "Pracujem" (oranžová, aktívne sledovanie), "Prepnuté — časovač beží ďalej" (žltá, v rámci okna tolerancie po prepnutí appky), alebo chip so zoznamom, ktoré sledované kreatívne appky sú práve otvorené, ak sa nič aktívne nesleduje.
• Aktívny projekt — farebná bodka, názov projektu a veľký monospace údaj o uplynutom čase.
• Dnešné sessions — posúvateľný zoznam všetkého sledovaného dnes, každý riadok ukazuje projekt, jeho odznak appky, časový rozsah a trvanie. Klikni na riadok pre pridanie alebo úpravu poznámky k danej session.
• Dnešný súčet — spoločný sledovaný čas za deň.
• Otvoriť RAVEN Hub / Nastavenia — rýchle akcie dole (Ukončiť nájdeš v menu pri pravom kliku — pozri vyššie).

Popup Quick Note

Keď skončí session sledovaná čisto podľa appky (nie podľa dokumentu — napr. Canva alebo CapCut, kde neexistuje reálny per-súbor názov projektu), objaví sa malý prompt: "Na čom si pracoval v appke {app}?" Napíš rýchlu poznámku alebo preskoč — udrží to zmysluplné časové záznamy na úrovni appky v tvojich reportoch. Tento popup sa dá vypnúť v Nastavenia → Sledovanie.

Hlavné okno

Otvorenie okna RAVEN Hubu (z popoveru, z globálnej skratky, alebo z Docku, kým je okno otvorené) prinesie pracovný priestor s piatimi kartami:

Samotné okno je zväčšiteľné (minimum zhruba 1350×680) a jeho zatvorenie appku neukončí — sledovanie beží ďalej na pozadí z menu baru.

Motivačný cieľový bar

Na spodku okna sa môže zobraziť tenký progress bar sledujúci vyfakturovaný obrat tohto kalendárneho roka voči ročnému cieľu, ktorý si nastavíš. Zapni ho a nastav cieľ v Nastavenia → Všeobecné. Po dosiahnutí cieľa sa zmení z modrej na zelenú — s jemným žiarením — a text sa prepne na "✓ Cieľ splnený +X · +Y%".

Projekty

Bočný panel Projektov je miesto, kde sa odohráva väčšina bežnej práce. Projekty sú organizované do zákaziek — zákazka zoskupuje všetky projekty patriace jednému klientovi či zákazke, takže vidíš spoločný čas a honorár bez zlučovania jednotlivých projektov.

Toolbar bočného panelu

Každá zákazka sa zobrazí ako farebný, rozbaliteľný priečinok s odznakmi appiek všetkého v ňom sledovaného, plus spoločný čas a honorár. Pod pomenovanými zákazkami sedí zväčšiteľný panel Samostatné projekty pre všetko nepriradené k zákazke — potiahnutím jeho horného okraja ho zväčšíš.

Akcie na riadku

Potiahnutím riadku projektu sa odkryjú rýchle akcie: vymazať a skryť/zobraziť na odchádzajúcej hrane, označiť uhradené/neuhradené na nabiehajúcej hrane. Pre celú sadu možností použi pravý klik.

Zákazky — kontextové menu

Pravý klik na zákazku (farebný priečinok zoskupujúci projekty klienta) otvorí:

Projekty — kontextové menu

Pravý klik na jednotlivý riadok projektu otvorí:

Vytvorenie projektu

Väčšina projektov sa objaví automaticky pri prvej detekcii, že na nich pracuješ. Projekt môžeš vytvoriť aj ručne cez + menu v bočnom paneli — hodí sa pre prácu, ktorá sa nesleduje automaticky, alebo na vopred nastavené URL sledovanie pre web appku.

Ručne vytvorené projekty nemajú v bočnom paneli odznak appky (neboli detekované z konkrétnej aplikácie).

Detail projektu

Kliknutím na projekt sa zobrazí šesť kariet, nasledovaných poznámkami, URL sledovaním a zoznamom sessions.

Poznámky

Voľné textové pole pre TODO, pokyny klienta, alebo čokoľvek, čo si chceš o projekte zapamätať — klikni na ikonu ceruzky/plus pre začatie úprav.

URL sledovanie

Pridaj alebo uprav text, ktorý má RAVEN Hub hľadať v adresnom riadku tvojho prehliadača na sledovanie času pre tento projekt (pozri Sledovanie prehliadača a URL ako funguje zhoda). Klikni Pridať/Upraviť, napíš reťazec ako client.sk/wp-admin, ulož. Odstránením rovnakým spôsobom vypneš web sledovanie pre tento projekt.

Sessions

Každý sledovaný interval je uvedený so svojím časovým rozsahom, prípadnou poznámkou, a (pri ručných záznamoch) malou ikonou štítku. Nečinný čas nad 60 sekúnd vnútri session sa zobrazuje oddelene od aktívneho času. Každý riadok sa dá upraviť (čas začiatku/konca, poznámka, štítok) alebo zmazať.

Pridať čas manuálne

Použi + Pridať čas manuálne pre prácu, ktorú RAVEN Hub nezachytil automaticky — telefonát s klientom, offline prácu, alebo session, ktorú si zabudol nechať zachytiť. Polia: popis práce, dátum, čas začiatku a čas konca (časy sa automaticky prehodia na nasledujúci deň, ak je koniec skorší než začiatok). Živý náhľad trvania sa aktualizuje za písania.

Prehľad odznakov appiek

Každý sledovaný projekt nesie malý farebný odznak zobrazujúci, ktorá appka ho vytvorila — presné farby použité v appke:

Projekt bez odznaku bol vytvorený ručne, nie detekovaný z aplikácie.

Automatické sledovanie času

RAVEN Hub rozpoznáva nasledujúce aplikácie hneď po nainštalovaní. Netreba nič nastavovať — jednoducho pracuj normálne a zodpovedajúci projekt sa objaví.

Ako funguje detekcia

Pre každú podporovanú appku sa RAVEN Hub snaží zistiť v ktorom dokumente či projekte práve aktívne si — nielen že je appka otvorená — cez viacvrstvový prístup:

1. Titulok okna (potrebuje oprávnenie Accessibility) — najspoľahlivejší zdroj; RAVEN Hub rozparsuje titulok per appku (napr. odstráni "— Adobe Premiere Pro 2026" alebo prípony workspace) a vytiahne len názov projektu.
2. Screen Recording ako záložný zdroj titulkov okien, keď samotné Accessibility žiadny nevráti.
3. Otvorené súbory — ak sa nenájde použiteľný titulok, RAVEN Hub skontroluje, ktorý projektový súbor má appka aktuálne otvorený (.prproj, .psd, .ai, .indd, .blend, .docx, .xlsx, .pages a podobné).
4. Fallback na názov appky — pre cloudové/webové nástroje bez lokálneho projektového súboru (Canva, CapCut) sa ako "projekt" použije priamo názov appky a pri ukončení session sa opýta na rýchlu poznámku.

Generické alebo dialógové titulky okien (veci ako "Open", "Save As", "Untitled", "Export") sa odfiltrujú v každom podporovanom UI jazyku, takže sa nikdy omylom nesledujú ako projekt.

Ktorá appka vyhráva, keď je otvorených viac

Ak je technicky aktívnych viac sledovaných kontextov naraz, RAVEN Hub vždy uprednostní v poradí: 1. natívna kreatívna/office appka (Adobe, Office, iWork, Xcode a pod.) → 2. Final Cut Pro → 3. zodpovedajúca URL v prehliadači. Sledovanie prehliadača sa použije len keď nič iné práve nie je aktívne.

Sledovanie prehliadača a URL

Pre webovú prácu — CMS, reklamná platforma, klientsky dashboard — vie RAVEN Hub sledovať čas podľa URL aktuálnej karty, porovnávanej s textovým vzorom, ktorý nastavíš na projekte (pozri URL sledovanie).

Zhoda je jednoduchá, nerozlišujúca veľkosť písmen kontrola podreťazca — ak sa nastavený vzor (napr. client.sk/wp-admin) objaví kdekoľvek v URL aktuálnej karty, spustí sa sledovanie tohto projektu. Nejde o striktnú zhodu domény, takže funguje aj pre smerovanie podľa query stringu.

Pri prvom použití konkrétneho prehliadača macOS zobrazí jednorazový dialóg s otázkou, či povoliť RAVEN Hubu ho ovládať — treba to povoliť, aby URL sledovanie fungovalo.

Nečinnosť, tolerancia a správanie sessions

Uspávanie a obnova po páde

Uspanie Macu čisto ukončí aktuálnu session. Ak sa RAVEN Hub alebo sledovaná appka nečakane ukončí uprostred session, nedokončená session sa automaticky uzavrie pri ďalšom spustení RAVEN Hubu, takže nikdy neskončíš so session navždy "bežiacou".

Upozornenie na nepomenovaný projekt

Ak aktívne pracuješ v dokumente, ktorý sa stále volá "Untitled" (alebo ekvivalent v jazyku appky) dlhšie ako 20 sekúnd, RAVEN Hub zobrazí jemné upozornenie, aby si ho pomenoval a uložil, s vysvetlením prečo: RAVEN Hub sleduje čas len na pomenovaných súboroch, takže bez uloženia sa táto práca k žiadnemu projektu nepriradí — rozpoznané názvy projektov sú v reportoch oveľa užitočnejšie než rad "Untitled-1", "Untitled-2"… Dá sa to vypnúť v Nastavenia → Všeobecné → Notifikácie.

Klienti

Karta Klienti drží kontaktné a fakturačné údaje, oddelené od samotných projektov, aby jeden klient mohol pokrývať viacero zákaziek.

Polia

Vyhľadávanie hľadá v mene, firme alebo e-maile. Triedenie podľa mena (A–Z alebo Z–A), najnovší, alebo najstarší. Prepínače v toolbare umožnia zobraziť/skryť súčty neuhradeného a skrytých klientov. Pravým klikom klienta skryješ alebo vymažeš.

Detail klienta

Otvorenie klienta zobrazí súhrnné karty (celkový čas, celkový honorár, uhradené, neuhradené), aktuálne priradené zákazky s per-zákazka časom/honorárom, blok fakturačných údajov a výrazné tlačidlo Vystaviť faktúru, ktoré otvorí novú faktúru už predvyplnenú údajmi tohto klienta.

Priraďovanie zákaziek klientovi

Klient automaticky "nevlastní" zákazku — spájaš ich explicitne. V detaile klienta klikni Priradiť zákazku vedľa nadpisu "Zákazky", potom zaškrtni, ktoré existujúce zákazky mu patria (a odškrtnutím zruš priradenie — zákazka a jej projekty ostanú nedotknuté, odstráni sa len prepojenie na klienta).

Zistenie, čo je stále neuhradené

Každý projekt uvedený pod zákazkou klienta zobrazí zelenú pilulku Uhradené po vyrovnaní — projekt bez pilulky je stále neuhradený — a súhrnná karta Neuhradené hore v klientovi to spočíta. Toto je najrýchlejší spôsob, ako per klient vidieť, čo ešte treba vyfakturovať alebo urgovať.

Fakturácia

Typy dokladov

Vytvorenie faktúry

Začni cez tlačidlo + v toolbare Faktúr, alebo z tlačidla klienta Vystaviť faktúru. Kľúčové polia:

DPH per položka

Každá položka môže niesť vlastnú sadzbu DPH, ktorá prepíše predvolenú na úrovni faktúry — hodí sa, keď jedna faktúra mieša položky so štandardnou aj zníženou/nulovou sadzbou. Súčty na obrazovke aj v PDF automaticky rozpíšu DPH podľa každej použitej sadzby zvlášť.

Formáty číslovania

Vyber, ako sa generujú čísla faktúr, v Nastavenia → Fakturácia. Každý typ dokladu (Faktúra / Zálohová / Cenová ponuka / Dobropis) si drží vlastný prefix a bežiaci počítadlo.

Menu Akcie (na otvorenom doklade)

Pod Akciami: Označiť ako uhradené, Upraviť, E-mail, a tlačidlo Export — jednoduché tlačidlo "PDF", ak nie je nastavený formát e-Faktúry, alebo menu ponúkajúce Uložiť len PDF, Exportovať e-Faktúru, a Poslať e-mailom, keď nastavený je. Každá faktúra si drží históriu odosielania/upomienok ukazujúcu komu a kedy sa poslal e-mail.

Hromadný export

Ikona exportu v toolbare Faktúr otvorí panel hromadného exportu: vyber rozsah dátumov (s rýchlymi tlačidlami pre tento mesiac / tento rok / minulý rok), filtruj podľa typu dokladu a stavu uhradenia, a exportuj každý zodpovedajúci doklad ako samostatné PDF do vybraného priečinka.

Formáty e-Faktúry

Viaceré krajiny už vyžadujú faktúry v štruktúrovanom XML formáte, nielen ako PDF. RAVEN Hub za teba vygeneruje správny súbor — za jeho odoslanie alebo nahratie zodpovedáš ty, keďže RAVEN Hub sa priamo neintegruje so žiadnym vládnym portálom. Nastav si formát raz v Nastavenia → Fakturácia.

Vzhľad PDF a QR kód

Každé vygenerované PDF nasleduje rovnaký A4 layout: tvoje logo vľavo hore, typ a číslo dokladu vpravo hore, trojstĺpcový blok (dodávateľ / odberateľ / dátumy a platba), tabuľka položiek s automatickým zalomením strán pri dlhých faktúrach, súčty s rozpisom DPH podľa sadzby, poznámky, podpisový riadok s nahratou pečiatkou ak je nastavená, a farebný platobný pás na spodku so zúčtovacím účtom, variabilným symbolom, splatnosťou a sumou.

Ak je zapnuté Zobraziť platobný QR, je nastavený IBAN a mena faktúry je EUR, pridá sa skenovateľný SEPA/EPC platobný QR kód — kompatibilný s bankovými appkami SK/CZ/EÚ, predvyplnený príjemcom, IBAN, sumou a referenciou.

Toto všetko — názov firmy, logo, adresa, IBAN, accent farba, a či sa QR vôbec zobrazí — sa nastaví raz v Nastavenia → Fakturácia a znova sa použije na každom doklade.

Odosielanie faktúr e-mailom

RAVEN Hub vie posielať faktúry a upomienky priamo, cez tvoj vlastný SMTP účet (nastavený raz v Nastavenia → E-mail) — nič neprechádza cez cudzí mail relay.

Panel odosielania predvyplní príjemcu zo záznamu klienta, automaticky vygenerovaný predmet a text (s rýchlou možnosťou poslať kópiu sebe), a pripojí faktúru ako {číslo}.pdf. Ak SMTP ešte nie je nastavené, panel zobrazí upozornenie smerujúce ťa do Nastavení namiesto tichého zlyhania.

Kalendár

Mesačná mriežka, kde je každý deň zafarbený podľa toho, koľko hodín si daný deň zaznamenal (štyri úrovne intenzity, od menej ako 30 minút po viac ako 5 hodín), s hodinovým súčtom vytlačeným na dlaždici. Vyhľadávacie pole stlmí dni, ktoré nezodpovedajú názvu projektu, aby si na prvý pohľad našiel aktivitu konkrétneho klienta.

Výber dňa otvorí detailný panel vpravo: celkový aktívny čas, potom sessions zoskupené najprv podľa zákazky a potom podľa projektu v nej, každá úroveň rozbaliteľná až po jednotlivé časové rozsahy. Tlačidlo v pätičke exportuje aktivitu daného dňa ako PDF alebo CSV.

Reporty a export

Štyri režimy reportov, každý s prepínačom rozsahu dátumov (7 dní / mesiac / rok / vlastný rozsah):

Export

Dostupný z Reportov, z kontextového menu zákazky, a z panelu dňa v Kalendári. Vyber filter platby (všetky / neuhradené / uhradené) a agregáciu: Detailný (jeden riadok per session), Denný, Týždenný, alebo Celkový súhrn (jeden riadok per projekt). Exportuj ako PDF (rešpektujúce tvoje nastavenie zaokrúhľovania času) alebo CSV.

Nastavenia

Šesť kariet, otvoríš ich z menu RAVEN Hub (⌘,) alebo z O aplikácii v appke.

Licencie a cenník

Každá inštalácia začína 14-dňovým bezplatným trialom — celá appka, žiadne obmedzenia funkcií, žiadna platobná karta. Trial hodiny sú uložené bezpečne a prežijú aj preinštalovanie appky.

Aktivácia licencie

Vlož svoj licenčný kľúč do poľa Máš licenčný kľúč? v Nastavenia → O aplikácii (alebo na obrazovke po vypršaní trialu) a klikni Aktivovať. Každý kľúč je viazaný vždy na jeden Mac.

Presun na nový Mac

Najprv klikni Odhlásiť zariadenie na súčasnom Macu — uvoľní to licenciu, aby sa dala aktivovať na inom zariadení.

Správa predplatného

Spravovať predplatné otvorí v prehliadači tvoj zákaznícky portál Lemon Squeezy, kde môžeš upraviť platobné údaje, zmeniť plán, alebo zrušiť.

Zálohy a bezpečnosť dát

Všetky tvoje dáta žijú lokálne na tvojom Macu — RAVEN Hub nad tým navyše drží automatické zálohy, bez potreby nastavovania.

• Zálohuje do iCloud Drive, ak je dostupné (bezpečné aj keby sa Mac stratil alebo poškodil), inak do ~/Documents, alebo do priečinka podľa tvojho výberu.
• Beží automaticky 90 sekúnd po spustení, potom každých 8 hodín (nastaviteľné), a znova krátko po akejkoľvek zmene dát — plus vyhradená záloha tesne pred inštaláciou aktualizácie.
• Bežné zálohy sa uchovávajú 2 mesiace; záloha tesne pred aktualizáciou appky sa uchováva natrvalo.
• Obnova vyberie snímku zo zoznamu a appku reštartuje, aby ju aplikovala.

Jazyky a meny

Jazyky rozhrania a faktúr (11)

Slovenčina, angličtina (UK), angličtina (US/CA), nemčina, čeština, francúzština, španielčina, taliančina, japončina, portugalčina (Brazília), ruština. Jazyk rozhrania appky zmeníš v Nastavenia → Všeobecné; každá jednotlivá faktúra môže navyše použiť iný jazyk dokladu než rozhranie.

Meny (15)

EUR, USD, GBP, CZK, CHF, JPY, CAD, AUD, PLN, HUF, SEK, NOK, DKK, BRL, RUB — nastavíš v Nastavenia → Fakturácia, so symbolom zobrazeným pred alebo za sumou, podľa výberu.

Klávesové skratky

Podpora

Otázky, spätná väzba, alebo niečo nefunguje tak, ako by malo — ozvi sa kedykoľvek na dev@kanda.sk alebo navštív www.ravenhub.sk. RAVEN Hub kontroluje aktualizácie automaticky a dá sa to skontrolovať aj ručne kedykoľvek cez Nastavenia → O aplikácii → Skontrolovať aktualizácie.