[[Obsidian Sync পরিচিতি|Obsidian Sync]] ডেস্কটপ অ্যাপ ব্যবহার না করেই ভল্ট সিঙ্ক করার জন্য একটি হেডলেস ক্লায়েন্ট প্রদান করে। CI পাইপলাইন, এজেন্ট এবং স্বয়ংক্রিয় ওয়ার্কফ্লোর জন্য উপযোগী। সর্বশেষ পরিবর্তনগুলো সিঙ্ক করুন অথবা ফাইলগুলো ক্রমাগত আপ টু ডেট রাখুন।
Obsidian ডেস্কটপ অ্যাপ ছাড়াই কমান্ড লাইন থেকে [[Obsidian Sync পরিচিতি|Obsidian Sync]]-এর সাথে ইন্টারঅ্যাক্ট করতে [[Obsidian Headless]] **(ওপেন বিটা)** ইনস্টল করুন। Headless Sync ডেস্কটপ অ্যাপের মতোই একই [[নিরাপত্তা ও গোপনীয়তা|এনক্রিপশন এবং প্রাইভেসি সুরক্ষা]] ব্যবহার করে, এন্ড-টু-এন্ড এনক্রিপশন সহ।
## দ্রুত শুরু
> [!error] শুরু করার আগে আপনার ডেটা ব্যাকআপ করুন
> 1. অপ্রত্যাশিত কিছু ঘটলে সেই ক্ষেত্রে শুরু করার আগে সবসময় আপনার ডেটা ব্যাকআপ করুন।
> 2. একই ডিভাইসে ডেস্কটপ অ্যাপ Sync এবং Headless Sync *উভয়ই* একসাথে ব্যবহার করবেন না, কারণ এতে ডেটা কনফ্লিক্ট হতে পারে। প্রতি ডিভাইসে শুধুমাত্র একটি সিঙ্ক পদ্ধতি ব্যবহার করুন।
[[Obsidian Headless|Obsidian Headless]] **(ওপেন বিটা)** ইনস্টল করুন:
```shell
npm install -g obsidian-headless
```
আপনার একটি সক্রিয় [[প্ল্যান ও স্টোরেজ সীমা|Obsidian Sync সাবস্ক্রিপশন]] থাকতে হবে।
```shell
# লগইন
ob login
# আপনার রিমোট ভল্টের তালিকা দেখুন
ob sync-list-remote
# সিঙ্কিংয়ের জন্য একটি ভল্ট সেটআপ করুন
cd ~/vaults/my-vault
ob sync-setup --vault "My Vault"
# একটি এককালীন সিঙ্ক চালান
ob sync
# ক্রমাগত সিঙ্ক চালান (পরিবর্তনের জন্য নজর রাখে)
ob sync --continuous
```
## কমান্ড
### `ob sync-list-remote`
শেয়ার্ড ভল্ট সহ, আপনার অ্যাকাউন্টের কাছে উপলব্ধ সব রিমোট ভল্টের তালিকা দেখান।
### `ob sync-list-local`
স্থানীয়ভাবে কনফিগার করা ভল্ট এবং তাদের পাথের তালিকা দেখান।
### `ob sync-create-remote`
একটি নতুন রিমোট ভল্ট তৈরি করুন।
```
ob sync-create-remote --name "Vault Name" [--encryption <standard|e2ee>] [--password <password>] [--region <region>]
```
| অপশন | বিবরণ |
| --- | --- |
| `--name` | ভল্টের নাম (আবশ্যক) |
| `--encryption` | ম্যানেজড এনক্রিপশনের জন্য `standard`, এন্ড-টু-এন্ড এনক্রিপশনের জন্য `e2ee` |
| `--password` | এন্ড-টু-এন্ড এনক্রিপশন পাসওয়ার্ড (বাদ দিলে জিজ্ঞাসা করা হবে) |
| `--region` | সার্ভার [[সিঙ্ক অঞ্চল\|অঞ্চল]] (বাদ দিলে স্বয়ংক্রিয়) |
### `ob sync-setup`
একটি লোকাল ভল্ট এবং একটি রিমোট ভল্টের মধ্যে সিঙ্ক সেটআপ করুন।
```
ob sync-setup --vault <id-or-name> [--path <local-path>] [--password <password>] [--device-name <name>] [--config-dir <name>]
```
| অপশন | বিবরণ |
| --- | --- |
| `--vault` | রিমোট ভল্টের আইডি বা নাম (আবশ্যক) |
| `--path` | লোকাল ডিরেক্টরি (ডিফল্ট: বর্তমান ডিরেক্টরি) |
| `--password` | E2E এনক্রিপশন পাসওয়ার্ড (বাদ দিলে জিজ্ঞাসা করা হবে) |
| `--device-name` | [[ভার্সন ইতিহাস\|সিঙ্ক ভার্সন ইতিহাসে]] প্রদর্শিত ডিভাইসের নাম |
| `--config-dir` | [[কনফিগারেশন ফোল্ডার\|কনফিগ ডিরেক্টরি]]-এর নাম (ডিফল্ট: `.obsidian`) |
### `ob sync`
একটি কনফিগার করা ভল্টের জন্য সিঙ্ক চালান।
```
ob sync [--path <local-path>] [--continuous]
```
| অপশন | বিবরণ |
| --- | --- |
| `--path` | লোকাল ভল্টের পাথ (ডিফল্ট: বর্তমান ডিরেক্টরি) |
| `--continuous` | ক্রমাগত চালান, পরিবর্তনের জন্য নজর রাখুন |
### `ob sync-config`
একটি ভল্টের জন্য [[সিঙ্ক সেটিংস ও নির্বাচিত সিঙ্কিং|সিঙ্ক সেটিংস]] দেখুন বা পরিবর্তন করুন। বর্তমান কনফিগারেশন প্রদর্শনের জন্য কোনো অপশন ছাড়াই চালান।
```
ob sync-config [--path <local-path>] [options]
```
| অপশন | বিবরণ |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--path` | লোকাল ভল্টের পাথ (ডিফল্ট: বর্তমান ডিরেক্টরি) |
| `--mode` | সিঙ্ক মোড: `bidirectional` (ডিফল্ট), `pull-only` (শুধুমাত্র ডাউনলোড করে, লোকাল পরিবর্তন উপেক্ষা করে), অথবা `mirror-remote` (শুধুমাত্র ডাউনলোড করে, লোকাল পরিবর্তন ফিরিয়ে দেয়) |
| `--conflict-strategy` | `merge` অথবা `conflict` |
| `--file-types` | সিঙ্ক করার জন্য অ্যাটাচমেন্টের ধরন: `image`, `audio`, `video`, `pdf`, `unsupported` (কমা দিয়ে আলাদা করা, খালি রাখলে ক্লিয়ার হবে) |
| `--configs` | সিঙ্ক করার জন্য কনফিগ ক্যাটাগরি: `app`, `appearance`, `appearance-data`, `hotkey`, `core-plugin`, `core-plugin-data`, `community-plugin`, `community-plugin-data` (কমা দিয়ে আলাদা করা, কনফিগ সিঙ্কিং নিষ্ক্রিয় করতে খালি রাখুন) |
| `--excluded-folders` | বাদ দেওয়ার জন্য ফোল্ডার (কমা দিয়ে আলাদা করা, খালি রাখলে ক্লিয়ার হবে) |
| `--device-name` | সিঙ্ক ভার্সন ইতিহাসে এই ক্লায়েন্টটি শনাক্ত করার জন্য ডিভাইসের নাম |
| `--config-dir` | কনফিগ ডিরেক্টরির নাম (ডিফল্ট: `.obsidian`) |
### `ob sync-status`
একটি ভল্টের সিঙ্ক স্ট্যাটাস এবং কনফিগারেশন দেখান।
```
ob sync-status [--path <local-path>]
```
### `ob sync-unlink`
সিঙ্ক থেকে একটি ভল্টের সংযোগ বিচ্ছিন্ন করুন এবং সংরক্ষিত ক্রেডেনশিয়াল সরিয়ে ফেলুন।
```
ob sync-unlink [--path <local-path>]
```
## নেটিভ মডিউল
Obsidian Headless-এ Windows এবং macOS-এ ফাইল তৈরির সময় (birthtime) সেট করার জন্য একটি প্রি-বিল্ট নেটিভ অ্যাডঅন অন্তর্ভুক্ত রয়েছে। এটি সার্ভার থেকে ফাইল ডাউনলোড করার সময় মূল তৈরির টাইমস্ট্যাম্প সংরক্ষণ করে।
অ্যাডঅনটি N-API ভার্সন 3-কে লক্ষ্য করে তৈরি করা, তাই কম্পাইল করা বাইনারিগুলো ABI-স্থিতিশীল এবং পুনরায় কম্পাইল না করেই Node.js-এর বিভিন্ন ভার্সন জুড়ে কাজ করে।
Linux-এ, birthtime সমর্থিত নয় — অ্যাডঅনটি অন্তর্ভুক্ত করা হয় না এবং এটি ছাড়াই সিঙ্ক স্বাভাবিকভাবে কাজ করে।
নিম্নলিখিতগুলোর জন্য প্রি-বিল্ট বাইনারি অন্তর্ভুক্ত রয়েছে:
- `win32-x64`
- `win32-arm64`
- `win32-ia32`
- `darwin-x64`
- `darwin-arm64`