सेटअप

HolyArrs को सोर्स कोड से बिल्ड करें और अपने ब्राउज़र में पोर्ट 6262 पर खोलें।

शुरू करने से पहले

• Go, उसी वर्ज़न का जो go.mod में लिखा है।
• Node 24 और npm.
• रेपो की जड़ में खुला एक टर्मिनल।

C कंपाइलर की ज़रूरत नहीं है। बिल्ड CGO_ENABLED=0 इस्तेमाल करते हैं।

बिल्ड करें और चलाएं

1. वेब ऐप के पैकेज इंस्टॉल करें:

   npm --prefix app/frontend ci

2. वेब ऐप बिल्ड करें:

   npm --prefix app/frontend run build

   बिल्ड पूरा होता दिखना चाहिए और app/frontend/dist फ़ाइलों से भर जाना चाहिए।

3. प्रोग्राम बिल्ड करें:

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

4. इसे अपने कॉन्फ़िग फ़ोल्डर के साथ चलाएं:

   ./bin/holyarrs -config ./config

5. http://localhost:6262 खोलें।

   पहली बार का विज़ार्ड दिखना चाहिए। ओनर अकाउंट बनाएं।

सावधानी

प्रोग्राम app/frontend/dist को अपने अंदर एम्बेड करता है। वेब ऐप में बदलाव के बाद, प्रोग्राम से पहले वेब ऐप दोबारा बिल्ड करें, वरना पुराने पेज मिलेंगे।

-config लोकल डिस्क का एक फ़ोल्डर लेता है और इसका डिफ़ॉल्ट /config है। -addr सुनने वाला एड्रेस बदलता है और इसका डिफ़ॉल्ट :6262 है।

वेब ऐप पर काम करें

प्रोग्राम को चलता रहने दें। दूसरे टर्मिनल में dev सर्वर शुरू करें:

npm --prefix app/frontend run dev

dev सर्वर सेव करते ही रीलोड होता है और API कॉल चल रहे प्रोग्राम को भेजता है। आपका बदलाव 2 s के अंदर ब्राउज़र में दिखना चाहिए।

विकल्प

Makefile इस्तेमाल करें

कमांड	क्या करती है
make ui	वेब पैकेज इंस्टॉल करती है और वेब ऐप बिल्ड करती है
make build	make ui, फिर bin/holyarrs बिल्ड करती है
make test	25 min के टाइमआउट के साथ go test
make vet	go vet ./...
make docker	इमेज को holyarrs:dev के नाम से बिल्ड करती है
make e2e	एंड-टू-एंड टेस्ट चलाती है

रोका हुआ फ़ीचर चालू करें

कुछ फ़ीचर रोके हुए हैं और बंद रहते हैं। उनके नाम HOLYARRS_FLAGS में कॉमा से अलग करके लिखें:

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

जो फ़ीचर बंद है, पेज उसे छिपा देते हैं, और उसके रूट मौजूद नहीं होते। यूज़र इनके बारे में रोके हुए फ़ीचर में पढ़ते हैं।

लाइब्रेरी को डेमो डेटा से भरें

डेमो टूल एक कॉन्फ़िग फ़ोल्डर को डेमो कलेक्शन से भर देता है। यह सिर्फ़ बंद HolyArrs पर और सिर्फ़ उस फ़ोल्डर पर काम करता है जिसे आपने लैब के तौर पर मार्क किया हो। इसे एक बार मार्क करें:

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

इसके बाद seed -config ./config डेमो लाइब्रेरी जोड़ता है और seed -config ./config -reset-demo सिर्फ़ वही हटाता है जो उसने जोड़ा था। मीडिया फ़ोल्डर /data/media ही होना चाहिए, जब तक आप -force न दें। dev टूल इमेज में नहीं जाते। dev टूल देखें।

अगर काम न करे

लक्षण। वेब ऐप बदलने के बाद भी पेज पुराने दिखते हैं। वजह। प्रोग्राम वही बिल्ड दिखाता है जो उसके अंदर एम्बेड हुआ था। हल। पहले वेब बिल्ड चलाएं, फिर Go बिल्ड, फिर प्रोग्राम शुरू करें।

लक्षण। go build इसलिए फ़ेल होता है कि app/frontend/dist नहीं मिला। वजह। वेब ऐप अभी बिल्ड नहीं हुआ है। हल। पहले चरण 2 चलाएं।

लक्षण। प्रोग्राम कहता है कि पोर्ट इस्तेमाल में है। वजह। कोई दूसरा HolyArrs या ऐप 6262 पर चल रहा है। हल। दूसरा एड्रेस दें: ./bin/holyarrs -config ./config -addr :6263.

एक्सपर्ट के लिए

रोके हुए फ़ीचर के स्विच

स्विच	फ़ीचर
plex_watchlists	Plex की वॉचलिस्ट रिक्वेस्ट बन जाती हैं
row_title_stats	ओनर के लिए एक्सप्लोर की लाइनों के आँकड़े
trakt_lists	Trakt की सूचियाँ
alert_channels_more	Discord और ईमेल के अलावा और अलर्ट चैनल
subtitle_sites	सबटाइटल साइट और सबटाइटल की खोज
emby_signin	Emby से साइन इन
go_back	पिछले वर्ज़न पर लौटने के चरण

नया स्विच जोड़ने के लिए, उसका नाम startup.RegisterFeature से रजिस्टर करें और उसके रूट रजिस्टर करने से पहले startup.FeatureOn जाँचें। नाम app/backend/internal/core/startup (feature.go) में रहते हैं।

dev टूल

टूल	कमांड	क्या करता है
डेमो	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 रूट दोबारा लिखता है

इमेज बिल्ड करें

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

इमेज FROM scratch से शुरू होती है और इसमें प्रोग्राम, CA सर्टिफ़िकेट और लाइसेंस होते हैं। यह -config /config -addr :6262 चलाती है।

इससे जुड़े पेज

• योगदान
• टेस्टिंग
• मॉड्यूल