সেটআপ

সোর্স থেকে HolyArrs বিল্ড করুন এবং ব্রাউজারে পোর্ট 6262-এ খুলুন।

শুরু করার আগে

Go, go.mod-এ যে ভার্সনের নাম আছে সেটি।
Node 24 এবং npm।
রিপোর রুটে একটি টার্মিনাল।

আপনার C কম্পাইলার লাগবে না। বিল্ড CGO_ENABLED=0 দিয়ে চলে।

বিল্ড করুন ও চালান

ওয়েব অ্যাপের প্যাকেজ ইনস্টল করুন:
Terminal window
```
npm --prefix app/frontend ci
```
ওয়েব অ্যাপ বিল্ড করুন:
Terminal window
```
npm --prefix app/frontend run build
```
আপনি দেখতে পাবেন বিল্ড শেষ হয়েছে এবং app/frontend/dist ফাইলে ভরে গেছে।
প্রোগ্রাম বিল্ড করুন:
Terminal window
```
go build -o bin/holyarrs ./app/backend/cmd/holyarrs
```
নিজের একটি কনফিগ ফোল্ডার দিয়ে চালান:
Terminal window
```
./bin/holyarrs -config ./config
```
http://localhost:6262 খুলুন।

আপনি প্রথমবার চালু করার উইজার্ড দেখতে পাবেন। মালিকের অ্যাকাউন্ট বানান।

-config লোকাল ডিস্কের একটি ফোল্ডার নেয়, ডিফল্ট /config। -addr শোনার ঠিকানা বদলায়, ডিফল্ট :6262।

ওয়েব অ্যাপ নিয়ে কাজ করুন

প্রোগ্রাম চালু রাখুন। দ্বিতীয় একটি টার্মিনালে ডেভ সার্ভার চালান:

npm --prefix app/frontend run dev

ডেভ সার্ভার সেভ করলেই রিলোড হয় এবং API কল চালু প্রোগ্রামে পাঠায়। আপনি 2 সেকেন্ডের মধ্যে ব্রাউজারে আপনার বদল দেখতে পাবেন।

বিকল্প

Makefile ব্যবহার করুন

কমান্ড	কী করে
`make ui`	ওয়েবের প্যাকেজ ইনস্টল করে ও ওয়েব অ্যাপ বিল্ড করে
`make build`	`make ui`, তারপর `bin/holyarrs` বিল্ড করে
`make test`	25 মিনিটের টাইমআউটসহ `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 শুধু যা যোগ করেছিল তা সরায়। -force না দিলে মিডিয়া ফোল্ডার /data/media হতে হবে। ডেভ টুল ইমেজের বাইরে থাকে। দেখুন ডেভ টুল।

কাজ না করলে

লক্ষণ: ওয়েব অ্যাপ বদলানোর পর পেজ পুরোনো দেখায়। কারণ: প্রোগ্রাম নিজের ভেতরে বসানো বিল্ডটিই সার্ভ করে। সমাধান: ওয়েব বিল্ড চালান, তারপর Go বিল্ড, তারপর প্রোগ্রাম চালু করুন।

লক্ষণ: app/frontend/dist না পেয়ে go build ফেল করে। কারণ: ওয়েব অ্যাপ এখনো বিল্ড করা হয়নি। সমাধান: আগে ধাপ 2 চালান।

লক্ষণ: প্রোগ্রাম বলে পোর্ট ব্যবহার হচ্ছে। কারণ: আরেকটি HolyArrs বা অ্যাপ 6262 ধরে রেখেছে। সমাধান: অন্য একটি ঠিকানা দিন: ./bin/holyarrs -config ./config -addr :6263।

বিশেষজ্ঞদের জন্য

আটকে রাখা সুইচ

সুইচ	ফিচার
`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)।

ডেভ টুল

টুল	কমান্ড	কী করে
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 রুট নতুন করে লেখে

ইমেজ বিল্ড করুন

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 দিয়ে চলে।

সংশ্লিষ্ট

HolyArrs বিনামূল্যে। এটি আপনার সময় বাঁচিয়ে থাকলে GitHub-এ স্টার দিন, স্পনসর করুন অথবা এক কাপ কফি কিনে দিন।