Uppsetning

Smíðaðu HolyArrs úr frumkóða og opnaðu það í browser á porti 6262.

Áður en þú byrjar

Go, í þeirri útgáfu sem go.mod nefnir.
Node 24 og npm.
Terminal í rót repo.

Þú þarft engan C-þýðanda. Smíðar nota CGO_ENABLED=0.

Smíðaðu og keyrðu

Settu upp pakka vefforritsins:
Terminal window
```
npm --prefix app/frontend ci
```
Smíðaðu vefforritið:
Terminal window
```
npm --prefix app/frontend run build
```
Þú ættir að sjá smíðina klárast og app/frontend/dist fyllast af skrám.

Smíðaðu forritið:

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

Keyrðu það með þinni eigin stillingamöppu:
Terminal window
```
./bin/holyarrs -config ./config
```
Opnaðu http://localhost:6262.

Þú ættir að sjá töframann fyrstu ræsingar. Búðu til eigandareikninginn.

-config tekur möppu á staðbundnum diski og er sjálfgefið /config. -addr breytir vistfanginu sem hlustað er á og er sjálfgefið :6262.

Vinndu í vefforritinu

Láttu forritið vera í gangi. Ræstu dev-server í öðru terminal:

npm --prefix app/frontend run dev

Hann hleður aftur þegar þú vistar og sendir API-köll á forritið sem er í gangi. Þú ættir að sjá breytinguna í browser innan 2 s.

Valkostir

Notaðu Makefile

Skipun	Gerir
`make ui`	Setur upp vefpakkana og smíðar vefforritið
`make build`	`make ui`, svo smíðar `bin/holyarrs`
`make test`	`go test` með 25 mín. tímamörkum
`make vet`	`go vet ./...`
`make docker`	Smíðar image sem `holyarrs:dev`
`make e2e`	Keyrir end-to-end prófin

Kveiktu á frestuðum eiginleika

Sumir eiginleikar eru frestaðir og haldast slökktir. Nefndu þá í HOLYARRS_FLAGS, aðskilda með kommum:

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

Síðurnar fela eiginleika sem er slökktur og leiðir hans eru ekki til. Notendur lesa um þá í Frestaðir eiginleikar.

Fylltu safnið af sýnigögnum

Demo-tólið fyllir stillingamöppu af sýnisafni. Það virkar aðeins á stöðvuðu HolyArrs og aðeins á möppu sem þú merktir sem lab. Merktu hana einu sinni:

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

Svo bætir seed -config ./config sýnisafninu við og seed -config ./config -reset-demo fjarlægir aðeins það sem það bætti við. Miðlamappan verður að vera /data/media nema þú gefir -force. Þróunartólin eru ekki í image. Sjá Þróunartól.

Ef það virkar ekki

Einkenni. Síðurnar líta út fyrir að vera gamlar eftir að þú breyttir vefforritinu. Orsök. Forritið sýnir vefútgáfuna sem var bökuð inn í það. Lausn. Keyrðu vefsmíðina, svo Go-smíðina, og ræstu svo forritið.

Einkenni. go build fellur vegna app/frontend/dist sem vantar. Orsök. Vefforritið er ekki smíðað enn. Lausn. Keyrðu skref 2 fyrst.

Einkenni. Forritið segir að portið sé í notkun. Orsök. Annað HolyArrs eða annað forrit heldur 6262. Lausn. Gefðu annað vistfang: ./bin/holyarrs -config ./config -addr :6263.

Fyrir sérfræðinga

Frestaðir rofar

Rofi	Eiginleiki
`row_title_stats`	Tölfræði á röðum í Explore fyrir eigandann
`trakt_lists`	Trakt-listar
`alert_channels_more`	Tilkynningarleiðir umfram Discord og tölvupóst
`subtitle_sites`	Textasíður og leit að skjátextum
`emby_signin`	Innskráning með Emby
`go_back`	Skref til að fara aftur í fyrri útgáfu

Til að bæta einum við skaltu skrá nafn hans með startup.RegisterFeature og athuga startup.FeatureOn áður en þú skráir leiðir hans. Nöfnin eru í app/backend/internal/core/startup (feature.go).

Þróunartól

Tól	Skipun	Gerir
Demo	`go run ./app/backend/tools/demo <command> -config DIR`	Vinnur á stöðvaðri stillingamöppu. Skipanir: `inspect` (talningar), `fingerprint`, `query "SELECT ..."` (skrifvarið), `doctor`, `seed`, `showcase`
Fölsk textasíða	`go run ./app/backend/tools/fakesubs`	Býður upp á falskar textasíður fyrir próf á `127.0.0.1:18727`. `-addr` færir það; `-accounts-addr` bætir við fölsunum á reikningasíðum
Leiðalisti	`go run ./app/backend/tools/apidoc`	Skrifar API-leiðir upp á nýtt

Smíðaðu image

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

Image byrjar FROM scratch og inniheldur forritið, CA-skírteini og leyfi. Það keyrir -config /config -addr :6262.

Tengt efni

HolyArrs er ókeypis. Ef það sparaði þér tíma geturðu gefið því stjörnu á GitHub, styrkt það eða boðið mér í kaffi.