Ρύθμιση

Κάνε build το HolyArrs από τον πηγαίο κώδικα και άνοιξέ το στο πρόγραμμα περιήγησης στη θύρα 6262.

Πριν ξεκινήσεις

• Go, στην έκδοση που ονομάζει το go.mod.
• Node 24 και npm.
• Ένα τερματικό στη ρίζα του repo.

Δεν χρειάζεσαι compiler της C. Τα builds χρησιμοποιούν CGO_ENABLED=0.

Build και εκτέλεση

1. Εγκατάστησε τα πακέτα της διαδικτυακής εφαρμογής:

   npm --prefix app/frontend ci

2. Κάνε build τη διαδικτυακή εφαρμογή:

   npm --prefix app/frontend run build

   Θα πρέπει να δεις το build να τελειώνει και τον φάκελο app/frontend/dist να γεμίζει αρχεία.

3. Κάνε build το πρόγραμμα:

   go build -o bin/holyarrs ./app/backend/cmd/holyarrs

4. Τρέξε το με έναν δικό σου φάκελο ρυθμίσεων:

   ./bin/holyarrs -config ./config

5. Άνοιξε το http://localhost:6262.

   Θα πρέπει να δεις τον οδηγό πρώτης εκκίνησης. Φτιάξε τον λογαριασμό του ιδιοκτήτη.

Προσοχή

Το πρόγραμμα ενσωματώνει το app/frontend/dist. Μετά από αλλαγή στη διαδικτυακή εφαρμογή, κάνε ξανά build τη διαδικτυακή εφαρμογή πριν από το πρόγραμμα, αλλιώς βλέπεις τις παλιές σελίδες.

Το -config παίρνει έναν φάκελο στον τοπικό δίσκο και από προεπιλογή είναι /config. Το -addr αλλάζει τη διεύθυνση ακρόασης και από προεπιλογή είναι :6262.

Δούλεψε στη διαδικτυακή εφαρμογή

Άφησε το πρόγραμμα να τρέχει. Σε ένα δεύτερο τερματικό, ξεκίνα τον dev server:

npm --prefix app/frontend run dev

Ο dev server φορτώνει ξανά με κάθε αποθήκευση και στέλνει τις κλήσεις API στο πρόγραμμα που τρέχει. Θα πρέπει να δεις την αλλαγή σου στο πρόγραμμα περιήγησης μέσα σε 2 s.

Επιλογές

Χρησιμοποίησε το Makefile

Εντολή	Κάνει
make ui	Εγκαθιστά τα πακέτα του web και κάνει build τη διαδικτυακή εφαρμογή
make build	make ui, μετά build του bin/holyarrs
make test	go test με timeout 25 λεπτών
make vet	go vet ./...
make docker	Κάνει build την image ως holyarrs:dev
make e2e	Τρέχει τις end-to-end δοκιμές

Ενεργοποίησε μια κρατημένη λειτουργία

Κάποιες λειτουργίες είναι κρατημένες και μένουν απενεργοποιημένες. Γράψε τα ονόματά τους στο HOLYARRS_FLAGS, χωρισμένα με κόμμα:

HOLYARRS_FLAGS=subtitle_sites,ai_apps ./bin/holyarrs -config ./config

Οι σελίδες κρύβουν μια λειτουργία που είναι απενεργοποιημένη, και οι διαδρομές της δεν υπάρχουν. Οι χρήστες διαβάζουν γι’ αυτές στις Κρατημένες λειτουργίες.

Γέμισε τη Βιβλιοθήκη με δεδομένα επίδειξης

Το εργαλείο demo γεμίζει έναν φάκελο ρυθμίσεων με μια συλλογή επίδειξης. Δουλεύει μόνο με σταματημένο HolyArrs και μόνο σε φάκελο που έχεις σημειώσει ως lab. Σημείωσέ τον μία φορά:

go run ./app/backend/tools/demo seed -config ./config -init-lab

Μετά το seed -config ./config προσθέτει τη Βιβλιοθήκη επίδειξης και το seed -config ./config -reset-demo αφαιρεί μόνο ό,τι πρόσθεσε. Ο φάκελος πολυμέσων πρέπει να είναι /data/media εκτός αν περάσεις -force. Τα εργαλεία ανάπτυξης μένουν έξω από την image. Δες τα Εργαλεία ανάπτυξης.

Αν δεν δουλεύει

Σύμπτωμα. Οι σελίδες φαίνονται παλιές αφού άλλαξες τη διαδικτυακή εφαρμογή. Αιτία. Το πρόγραμμα σερβίρει το build που έχει ενσωματώσει. Λύση. Τρέξε το web build, μετά το Go build, και μετά ξεκίνα το πρόγραμμα.

Σύμπτωμα. Το go build αποτυγχάνει επειδή λείπει το app/frontend/dist. Αιτία. Η διαδικτυακή εφαρμογή δεν έχει γίνει ακόμα build. Λύση. Τρέξε πρώτα το βήμα 2.

Σύμπτωμα. Το πρόγραμμα λέει ότι η θύρα χρησιμοποιείται. Αιτία. Άλλο HolyArrs ή άλλη εφαρμογή κρατά το 6262. Λύση. Πέρασε άλλη διεύθυνση: ./bin/holyarrs -config ./config -addr :6263.

Για έμπειρους

Διακόπτες κρατημένων λειτουργιών

Διακόπτης	Λειτουργία
row_title_stats	Στατιστικά στις γραμμές της Εξερεύνησης για τον ιδιοκτήτη
trakt_lists	Λίστες Trakt
alert_channels_more	Κανάλια ειδοποιήσεων πέρα από Discord και email
subtitle_sites	Ιστότοποι υποτίτλων και αναζήτηση υποτίτλων
emby_signin	Σύνδεση με Emby
go_back	Βήματα για επιστροφή στην προηγούμενη έκδοση

Για να προσθέσεις έναν, δήλωσε το όνομά του με startup.RegisterFeature και έλεγξε το startup.FeatureOn πριν δηλώσεις τις διαδρομές του. Τα ονόματα βρίσκονται στο app/backend/internal/core/startup (feature.go).

Εργαλεία ανάπτυξης

Εργαλείο	Εντολή	Κάνει
Demo	go run ./app/backend/tools/demo <command> -config DIR	Δουλεύει σε σταματημένο φάκελο ρυθμίσεων. Εντολές: inspect (μετρήσεις), fingerprint, query "SELECT ..." (μόνο για ανάγνωση), doctor, seed, showcase
Ψεύτικος ιστότοπος υποτίτλων	go run ./app/backend/tools/fakesubs	Σερβίρει ψεύτικους ιστότοπους υποτίτλων για δοκιμές στο 127.0.0.1:18727. Το -addr τον μετακινεί· το -accounts-addr προσθέτει τα ψεύτικα των ιστότοπων με λογαριασμό
Λίστα διαδρομών	go run ./app/backend/tools/apidoc	Ξαναγράφει τις Διαδρομές API

Build της image

docker build --file deploy/Dockerfile --tag holyarrs:dev .
docker run -p 6262:6262 -v ./config:/config holyarrs:dev

Η image ξεκινά FROM scratch και περιέχει το πρόγραμμα, πιστοποιητικά CA και άδειες χρήσης. Τρέχει με -config /config -addr :6262.

Σχετικά

• Συνεισφορά
• Δοκιμές
• Modules