Pierwsze kroki
- Otwórz aplikację w przeglądarce Chrome lub Edge, na komputerze, tablecie albo telefonie. Adres dostaniesz od nas, np. https://ripworth.com. Jeśli aplikacja działa na komputerze w sklepie, adres to http://localhost:5177.
- Gdy przeglądarka zapyta o dostęp do kamery, kliknij Zezwól. Kamera jest potrzebna tylko do zdjęć z aplikacji i trybu na żywo.
- Na górze strony wybierz grę, np. Pokémon, albo zostaw Wszystkie gry. Wybór jednej gry przyspiesza rozpoznawanie i zmniejsza ryzyko pomyłki.
- Zrób zdjęcie karty. Po chwili zobaczysz nazwę, wersję i wartość.
Skanowanie zdjęcia
W zakładce Skanuj masz kilka sposobów podania zdjęcia:
- Zrób lub wybierz zdjęcie: na telefonie otwiera aparat, na komputerze wybór pliku.
- Aparat w aplikacji: podgląd kamery na stronie, potem Zrób zdjęcie.
- Przeciągnij plik ze zdjęciem na pole albo wklej obraz skrótem Ctrl+V.
Aplikacja sama znajdzie kartę na zdjęciu, wyprostuje ją i porówna z całą bazą. Pod zdjęciem widać kolejne kroki, a na końcu „Rozpoznano: …”.
Jak zrobić dobre zdjęcie
- Cała karta w kadrze, najlepiej na jednolitym tle (kartka, mata).
- Bez mocnych odblasków. Przy kartach holo przechyl kartę lekko, aż odblask zniknie.
- Karta może być w koszulce lub toploaderze i nie musi leżeć idealnie prosto.
- Jedna karta na zdjęciu – chyba że włączysz tryb wielu kart (niżej).
Wiele kart na jednym zdjęciu
Przy skupie kolekcji zaznacz Wiele kart na jednym zdjęciu pod przyciskami i zrób jedno zdjęcie, np. 9 kart rozłożonych na macie. Aplikacja ponumeruje karty na zdjęciu, rozpozna każdą i pokaże listę z cenami i sumą. Karty oznaczone „sprawdź” kliknij i potwierdź wersję. + Dodaj pewne do sesji dopisuje rozpoznane na pewno. Karty powinny leżeć osobno, nie na zakładkę.
Jak czytać wynik
| Element | Co oznacza |
|---|---|
| RAW (duża cena) | Wartość karty bez gradingu, w złotówkach (lub wybranej walucie). Pod spodem cena źródłowa w USD z TCGplayer i cena z Cardmarket w EUR. |
| PSA 9 / PSA 10 | Wartość karty po gradingu. Bez klucza PriceCharting aplikacja pokazuje linki do sprzedanych aukcji na eBay. |
| Pewność | Jak bardzo aplikacja jest pewna rozpoznania. Przy niepewnym wyniku pojawia się napis „Niepewne rozpoznanie – sprawdź kartę” i lista podobnych kart do wyboru. |
| Inne wersje | Ta sama karta w innych wersjach: alt art, reverse, 1st Edition, wydanie EN / JP, przedruki. Kliknij wersję, żeby zobaczyć jej cenę. |
| Ceny raw wg wariantu | Tabela cen wszystkich wariantów (np. Holo, Reverse Holo): cena rynkowa, najniższa oferta i przeliczenie na złotówki. |
| Skupimy za / Cena w sklepie | Jeśli sklep ustawił procent skupu i sprzedaży w panelu, aplikacja od razu liczy, ile zapłacić za kartę i za ile ją sprzedać. |
| Stan karty | Przyciski NM / LP / MP / HP / DMG. Ceny rynkowe dotyczą stanu Near Mint; dla gorszego stanu aplikacja pokazuje szacunek według typowych przeliczników rynku (np. LP ≈ 85%, HP ≈ 50%) i tak liczy skup oraz sesję. |
| ▲ / ▼ przy Cardmarket | Trend: średnia cena z ostatnich 7 dni względem 30 dni. Widać go, gdy zmiana wynosi co najmniej 5%. |
| Czy gradować? | Pomiar centrowania ze zdjęcia, szansa na PSA 9 / 10 i opłacalność gradingu po kosztach. Koszty ustawisz w zakładce Ustawienia. |
Przyciski pod ceną:
- + Dodaj do sesji: dopisuje kartę do listy w zakładce Sesja.
- 📺 Pokaż na streamie: wysyła kartę z ceną na nakładkę OBS.
- Linki TCGplayer, Cardmarket, PriceCharting, eBay sprzedane, PSA pop otwierają kartę w tych serwisach.
Aplikacja uczy się na Twoich poprawkachGdy klikniesz inną wersję niż proponowana albo dodasz niepewny wynik do sesji, zdjęcie zostaje zapamiętane jako wzorzec tej karty. Następny skan tej karty w podobnych warunkach (ta sama mata, koszulka, światło) od razu wskaże właściwą wersję. Wzorce są tylko w Twoim sklepie.
Zawsze porównaj zdjęciePrzy każdym wyniku widać zdjęcie karty z bazy. Rzuć na nie okiem, zwłaszcza przy drogich kartach. Aplikacja woli powiedzieć „nie wiem” i pokazać listę niż wskazać złą kartę, ale przy nietypowym zdjęciu pomyłka jest możliwa.
Wyszukiwanie ręczne
Pole Albo wyszukaj ręcznie pod zdjęciem przyjmuje nazwę karty, numer albo jedno i drugie. Przykłady:
Charizard ex 223/197OP05-119(One Piece)FB01-139(Dragon Ball Fusion World)LOB-EN001(Yu-Gi-Oh!)
Kliknij Szukaj albo naciśnij Enter. Jeśli pasuje kilka kart, wybierz właściwą wersję w panelu wyniku.
Tryb na żywo
Zakładka 🔴 Na żywo rozpoznaje karty z obrazu na bieżąco, np. podczas otwierania boosterów na streamie.
- Wybierz źródło obrazu: kamerę z listy (także OBS Virtual Camera), 🖥️ Przechwyć okno (okno albo kartę przeglądarki ze streamem: Whatnot, TikTok, Twitch, YouTube) albo 🎞️ Plik wideo.
- Pokaż kartę i zatrzymaj ją na chwilę (ok. pół sekundy). Aplikacja sama ją rozpozna, doda do sesji i, jeśli zaznaczone, wyśle na nakładkę. Zwykle trwa to od 1 do 1,5 sekundy.
- Pokaż następną kartę. Ta sama karta leżąca w tym samym miejscu nie jest wysyłana ponownie.
Opcje
- Rozpoznawaj automatycznie: rozpoznaje każdą kartę zatrzymaną w kadrze.
- Wysyłaj na nakładkę OBS: rozpoznana karta od razu trafia na wizję.
- ⚡ Rozpoznaj teraz: wymusza rozpoznanie bieżącej klatki (z dokładniejszym odczytem tekstu).
- Zaznacz prostokąt myszką lub palcem na podglądzie, gdy karta na streamie jest mała. Aplikacja będzie szukać karty tylko w tym miejscu. Zaznaczenie usuwa ✕ Usuń zaznaczony obszar.
Bezpiecznik dla widzówNiepewne rozpoznania nie trafiają na stream. Jeśli przedruki tej samej karty mają bardzo różne ceny, aplikacja też wstrzyma wysyłkę i pokaże wersje do wyboru w panelu. Widzowie nie zobaczą ceny innej karty.
Nakładka OBS
Nakładka pokazuje widzom rozpoznaną kartę z ceną, logo i danymi sklepu.
- W OBS kliknij Źródła → + → Przeglądarka.
- Wpisz adres nakładki: adres aplikacji + /overlay.html, np. http://localhost:5177/overlay.html.
- Ustaw szerokość 1920 i wysokość 1080. Tło jest przezroczyste.
- W zakładce Na żywo rozwiń Jak dodać nakładkę do OBS? i kliknij Wyślij testową kartę na nakładkę, żeby sprawdzić, czy działa.
Dodatki do adresu
| Dopisz do adresu | Co zmienia |
|---|---|
?pos=br | Róg ekranu: br prawy dolny, bl lewy dolny, tr prawy górny, tl lewy górny. |
&hold=12 | Ile sekund karta jest widoczna. |
&cur=PLN | Waluta na nakładce: PLN, USD albo EUR. |
&sound=0 | Wyłącza dźwięki tylko w tej nakładce. |
&vol=0.5 | Głośność tej nakładki (0–1), niezależnie od ustawienia w panelu. |
&hits=0 | Wyłącza efekty hitów tylko w tej nakładce. |
Przykład: http://localhost:5177/overlay.html?pos=bl&hold=8&cur=PLN
Hity i dźwięk
Gdy rozpoznana karta jest warta co najmniej ustaloną kwotę, nakładka świętuje razem z widzami:
| Poziom | Domyślnie od | Co widać i słychać |
|---|---|---|
| HIT! | 100 zł | Złota, pulsująca ramka, plakietka „HIT!”, konfetti i cena „nabijana” od zera. Dźwięk dzwonka. |
| BIG HIT! | 500 zł | Do tego iskry wokół planszy i błysk przesuwający się po karcie. Dźwięk „whoosh” i akord. Karta zostaje na ekranie 1,5× dłużej. |
| MEGA HIT! | 2000 zł | Karta najpierw na środku ekranu z promieniami światła i złotym deszczem, potem trafia do rogu. Werbel i fanfara. Karta zostaje 2× dłużej. |
Progi, napisy, dźwięk, głośność, motyw nakładki (klasyczny, neon, minimalistyczny) i własne dźwięki sklepu (MP3 / OGG / WAV dla każdego poziomu – np. jingiel sklepu przy MEGA HIT) ustawisz w Panelu sklepu → Hity i dźwięk na streamie. Tam są też przyciski ▶ Test: HIT, ▶ Test: BIG HIT i ▶ Test: MEGA HIT. Przy zwykłych kartach nakładka gra tylko krótki dźwięk rozpoznania (można go wyłączyć).
Dźwięk w OBSWe właściwościach źródła „Przeglądarka” zaznacz Steruj dźwiękiem przez OBS. Dźwięk nakładki pojawi się wtedy w mikserze jako osobny kanał, a jego głośność ustawisz suwakiem.
Prowadzenie streamu
W zakładce 🔴 Na żywo, pod nakładką, jest panel 📦 Stream. Każda karta pokazana na nakładce trafia do dziennika streamu z wartością.
| Funkcja | Jak użyć |
|---|---|
| Break / box | Wpisz nazwę (np. „OP17 Booster Box”) i koszt w zł, kliknij ▶ Start breaka. Licznik sumuje wartość wyciągniętych kart i pokazuje wynik: na plusie czy na minusie. |
| Karta dla widza | Wpisz nick widza (np. przy breakach na drużyny). Następne karty na nakładce mają dopisek „🎁 dla @nick”, a raport sumuje wartość dla każdego widza. |
| ↶ Cofnij ostatnią | Usuwa z dziennika kartę pokazaną przez pomyłkę. |
| 🎯 Zgadywanka | Widzowie mają 30 s, żeby wpisać na czacie Twitch !cena 250. Po pokazaniu następnej karty nakładka ogłasza, kto był najbliżej. Wymaga nazwy kanału Twitch w panelu sklepu. |
| 📄 Raport streamu | Podsumowanie: liczba kart, łączna wartość, hity, najlepsze pulle, wyniki breaków, widzowie i pełna lista. Do druku / PDF albo jako CSV. Poprzednie streamy są w archiwum raportów. |
| 🆕 Nowy stream | Zaczyna dziennik od zera; poprzedni stream trafia do archiwum raportów. |
Aplikacja na serwerze w internecieGdy RipWorth działa na serwerze (np. ripworth.com), sterowanie streamem – wysyłka na nakładkę, break, cofnięcie, zgadywanka, pilot, raport – jest chronione, żeby nikt obcy nie zmieniał Twojego streamu. Przy pierwszej takiej akcji w panelu streamu pojawi się prośba o hasło panelu sklepu; po jego podaniu ta przeglądarka zostaje odblokowana na stałe. Na komputerze, na którym działa aplikacja, nic nie trzeba odblokowywać.
Nakładka statystyk
Drugie źródło „Przeglądarka” w OBS z adresem http://localhost:5177/overlay-stats.html (adres jest też w panelu do skopiowania) pokazuje licznik breaka i tabelę najlepszych pulli, aktualizowane na żywo. Dodatki: ?show=break albo ?show=top (tylko jeden element), &pos=tr (róg), &n=5 (ile kart w tabeli).
📱 Pilot na telefonie
W panelu streamu rozwiń Pilot na telefonie i zeskanuj kod QR telefonem. Na telefonie widzisz aktualną kartę z ceną i jej wersje: dotknięcie wybiera wersję, duże przyciski pokazują kartę na streamie, dodają do sesji, cofają ostatnią, uruchamiają zgadywankę albo ręcznie wywołują HIT / BIG / MEGA. Telefon łączy się kodem parowania – bez niego nikt nie steruje Twoim streamem.
🎬 Klip hita (OBS)
Przy hicie nakładka może sama zapisać kilka ostatnich sekund nagrania z bufora powtórek OBS – gotowy materiał na TikToka czy Reels.
- W OBS: Ustawienia → Wyjście → Bufor powtórek – włącz i ustaw długość (np. 30 s).
- W OBS: Narzędzia → Ustawienia serwera WebSocket – włącz serwer, zanotuj port i hasło.
- Do adresu nakładki dopisz
&obs=HASŁO(oraz&obsport=4455, jeśli port jest inny, i&clip=2– od którego poziomu hita zapisywać, domyślnie BIG HIT).
Hasło zostaje tylko w ustawieniach źródła w OBS – nie trafia do aplikacji ani na serwer.
Sesja i eksport
Zakładka 🗂️ Sesja zbiera karty z transmisji i skanowania, z łączną wartością. Przydaje się przy wycenie całej kolekcji przy ladzie albo podsumowaniu streamu.
- ⬇ CSV zapisuje listę do pliku, który otworzysz w Excelu lub Arkuszach Google (nazwa, set, numer, ceny).
- Wyczyść zaczyna nową sesję.
Ustawienia
| Ustawienie | Kiedy zmienić |
|---|---|
| Rozpoznawanie | Automatycznie (zalecane): obraz, potem numer karty, a przy wątpliwości AI. Bez AI: wszystko działa lokalnie i bez opłat. Zawsze AI: dla trudnych przypadków; jest wolniejsze i płatne. |
| Wersja językowa przy wątpliwości | Gdy sklep ma głównie karty angielskie albo japońskie (Pokémon EN/JP, Naruto Kayou EN/CN). Rozstrzyga przypadki, gdy obraz jest taki sam w obu językach. |
| Waluta główna | PLN, USD albo EUR jako duża cena w wyniku. |
| Gry, w których szukać | Zaznacz tylko gry, którymi handlujesz. Rozpoznawanie będzie szybsze i pewniejsze. |
| Koszty gradingu | Opłata PSA i wysyłka za kartę. Na tej podstawie kalkulator mówi, czy gradowanie się opłaca. |
Panel sklepu
Panel otwierasz z zakładki Ustawienia przyciskiem Panel sklepu. Wymaga hasła administratora ustawionego przy pierwszej konfiguracji.
- Wygląd i marka: logo, nazwa sklepu, podtytuł i kolor przewodni (przyciski, ramki, nakładka).
- Kontakt: strona WWW, telefon i adres w stopce i na nakładce.
- Reklama na streamie: rotujące hasła (np. „-10% z kodem STREAM”), kod QR na planszy z kartą i znaczek sklepu w rogu ekranu, gdy żadna karta nie jest pokazywana.
- Ceny sklepu: procent wartości rynkowej dla „Skupimy za” (np. 60%) i „Cena w sklepie” (np. 110%). Widać je przy każdej karcie i na streamie.
- Własne katalogi: karty spoza głównej bazy (np. Naruto, często sprzedawane karty sportowe). Dodajesz je zdjęciem albo listą CSV i od razu są rozpoznawane. Cenę ustala sklep.
- Katalog kart: baza odświeża się sama raz na dobę. W dniu premiery możesz kliknąć Odśwież katalog teraz.
Klucze do usług zewnętrznych (AI, ceny PSA, eBay, SportsCardsPro) wpisuje się w Kreator konfiguracji. Są zapisane tylko na serwerze sklepu i w przeglądarce widać jedynie ich końcówkę.
Skąd są ceny
| Źródło | Co daje | Gry |
|---|---|---|
| TCGplayer | Cena rynkowa, najniższa oferta i warianty, w USD. Aktualizacja codziennie. | Wszystkie gry z bazy |
| Cardmarket | Trend, średnia z 30 dni i najniższa oferta, w EUR. Aktualizacja codziennie. | Pokémon EN, One Piece, Magic: The Gathering, Yu-Gi-Oh! |
| PriceCharting | Ceny PSA 7–10, CGC 10, BGS 10 (wymaga klucza). | Gry TCG |
| SportsCardsPro, eBay | Ceny ze sprzedaży i bieżące oferty. | Karty sportowe, Naruto |
| NBP | Bieżący kurs USD i EUR do przeliczenia na złotówki. | Wszystkie |
Oznaczenia przy cenach
- „od X”: karta nie miała ostatnio sprzedaży, więc pokazujemy najniższą ofertę. Pojedynczej oferty z ceną zaporową (np. 10 000 $ za zwykłą kartę) nie pokazujemy.
- „średnia z 30 dni” przy Cardmarket: trend nagle wystrzelił po kilku nietypowych sprzedażach, więc pokazujemy stabilniejszą średnią.
- „≈”: wartość przybliżona, z małej liczby sprzedaży lub ofert. Obok widać źródło i liczbę danych.
- „szacunek”: wartość według rzadkości karty, gdy nie ma żadnych sprzedaży. Widać ją tylko w aplikacji, nie na streamie.
- 🗓 Premiera: karta przed premierą. Cena pochodzi z pojedynczych ofert przedsprzedaży.
- 🆕 Nowość: set wydany w ostatnich 30 dniach. Ceny mogą się jeszcze mocno zmieniać.
Karty z nowych setów pojawiają się w bazie, gdy doda je TCGplayer, zwykle już w przedsprzedaży.
Wersja testowa
Wersja testowa działa tak samo jak wersja dla sklepu: skanowanie, tryb na żywo, ceny i sesja. Różnice:
- Panel sklepu i kreator konfiguracji są wyłączone. Logo i dane sklepu to RipWorth.
- Jest limit rozpoznań na minutę z jednego adresu. Przy bardzo szybkim skanowaniu może pojawić się komunikat „Za dużo zapytań – spróbuj za minutę”.
- Nakładka OBS jest wspólna dla wszystkich testujących, więc możesz na niej zobaczyć karty innych osób.
Prosimy o uwagiZapisz, które karty zostały źle rozpoznane albo nie miały ceny (nazwa, numer, najlepiej zdjęcie). Te informacje najbardziej pomagają nam poprawić skuteczność.
Problemy i pytania
- Kamera nie działa albo nie ma jej na liście.
- Sprawdź, czy przeglądarka ma zgodę na kamerę (ikona kłódki obok adresu). Kamera działa tylko na stronie z https:// albo na localhost. Zamknij inne programy, które mogą jej używać (Zoom, Teams, OBS z tą samą kamerą).
- Karta nie została rozpoznana.
- Zrób zdjęcie jeszcze raz: cała karta, bez odblasku, na jednolitym tle. Wybierz grę na górze strony. Jeśli dalej nic, wpisz nazwę lub numer w wyszukiwarce. Bardzo nowe karty mogą jeszcze nie mieć zdjęcia w bazie i wtedy pomaga numer.
- Aplikacja wybrała złą wersję karty.
- Kliknij właściwą wersję pod wynikiem – aplikacja zapamięta to zdjęcie jako wzorzec. Wersje rozpoznaje po zdjęciu: kolor ramki (np. złota i srebrna Magikarp z Classic Collection), pieczątki i znaczki (Prerelease, Staff, logo setu), wydanie EN / JP. Wersje różniące się tylko drobnym szczegółem (np. 1st Edition, Shadowless) aplikacja zawsze oznacza ostrzeżeniem i pokazuje ceny wszystkich.
- Nie ma ceny Cardmarket.
- Cardmarket jest dostępny dla Pokémon EN, One Piece, Magic: The Gathering i Yu-Gi-Oh!. Jeśli wersje nie dają się dopasować pewnie, aplikacja woli nie pokazać ceny niż pokazać cenę innej wersji.
- Pierwsze rozpoznanie trwa dłużej.
- Przy pierwszym skanie przeglądarka ładuje narzędzia do rozpoznawania. Kolejne karty idą w około sekundę.
- Karta na streamie jest mała i nie jest wykrywana.
- W trybie na żywo zaznacz myszką prostokąt w miejscu, gdzie pokazywane są karty.
- Nakładka w OBS nic nie pokazuje.
- Sprawdź adres źródła przeglądarki i kliknij „Wyślij testową kartę na nakładkę”. Po zmianie adresu kliknij w OBS „Odśwież pamięć podręczną bieżącej strony”.