आपका प्रोजेक्टर, Home Assistant और Hubitat में।

• यह स्थिति पब्लिश करता है। प्रोजेक्टर Home Assistant सेंसर, Hubitat डिवाइस या आपके वेबहुक पर JSON पेलोड के रूप में दिखता है, और उसमें वही रीडिंग होती हैं जो ऐप आपको दिखाता है।
• यह कंट्रोल पब्लिश करता है। आपका सेव किया हर सीन, साथ ही पावर, हर इनपुट, हर कलर मोड और हर लेंस मेमोरी, ऐसी चीज़ बन जाती है जिसे ऑटोमेशन या वॉइस असिस्टेंट चला सकता है।
• यह सर्वर-रहित चलता है। स्क्रिप्ट सेट हो जाने के बाद Home Assistant कमांड सीधे प्रोजेक्टर के IP पते पर भेजता है। आपके फ़ोन का नेटवर्क पर होना ज़रूरी नहीं, और कुछ भी क्लाउड अकाउंट से होकर नहीं गुज़रता।

तीन रास्ते, एक हब

सेटिंग › होम ऑटोमेशन ही हब है। जो प्लेटफ़ॉर्म आप चलाते हैं वह चुनें - Home Assistant, Hubitat या वेबहुक - और वहीं सेट करें। आप एक साथ एक से ज़्यादा जोड़ सकते हैं; वे एक-दूसरे से स्वतंत्र हैं।

1. सेटिंग › होम ऑटोमेशन › Home Assistant खोलें।
2. अपना Home Assistant पता टाइप करें (जैसे http://homeassistant.local:8123 या उसका IP), फिर Sign in पर टैप करें। यह आपके अपने इंस्टेंस पर ब्राउज़र से साइन-इन है - कोई टोकन पेस्ट करने की ज़रूरत नहीं। अपना सामान्य Home Assistant लॉगिन इस्तेमाल करें, टू-फ़ैक्टर समेत।
3. ऐप प्रोजेक्टर को सेंसर के रूप में पब्लिश करता है, sensor.projector_pilot_epson_qb1000b_qb1000w जैसी एंटिटी के साथ, जिसमें पावर, इनपुट, कलर मोड, पिक्चर के आंकड़े और लैंप घंटे होते हैं।
4. प्रोजेक्टर की स्थिति भेजें चालू करें ताकि ऐप खुले रहने के दौरान वे रीडिंग बदलते ही Home Assistant में अपडेट हों, और पिक्चर मोड, इनपुट, लेंस मेमोरी और पावर की स्क्रिप्ट पब्लिश करने के लिए Sync Advanced Controls चालू करें।
5. एक shell_command ब्लॉक (नीचे) अपने configuration.yaml में पेस्ट करें, Home Assistant रीस्टार्ट करें, फिर Sync With HA पर टैप करें।

shell_command ब्लॉक

यही पूरी सर्वर-रहित तरकीब है। ऐप एक कमांड लिखता है जिसे Home Assistant प्रोजेक्टर के Web Control से बात करने के लिए चलाता है, और उसकी हर सिंक की हुई स्क्रिप्ट उसी कमांड को अलग क्रिया के साथ कॉल करती है। ऐप में Copy block पर टैप करें और उसे configuration.yaml में पेस्ट करें। नीचे का उदाहरण सिर्फ़ समझाने के लिए है - ऐप आपके प्रोजेक्टर का अपना पता और कमांड का नाम भर देता है:

shell_command:
  projector_pilot_epson: >-
    curl -s --max-time 5 --digest -u 'EPSONWEB:'
    -H "X-Requested-With: XMLHttpRequest"
    -H "Referer: http://192.168.1.50/cgi-bin/webconf"
    "http://192.168.1.50/cgi-bin/directsend?{{ verb }}={{ value | urlencode }}"

सिर्फ़ उदाहरण। ऐप आपके लिए प्रोजेक्टर का असली IP और उसके सीरियल से बना नाम लेकर इसे बनाता है।

Test Connection, सिंक और सफ़ाई

• Test Connection जाँचता है कि ऐप आपके Home Assistant तक पहुंच सकता है और पेस्ट किया हुआ shell_command सचमुच वहाँ है, ताकि उसके ऊपर कुछ भी बनाने से पहले आपको टाइपो पता चल जाए।
• Sync With HA आपके सीन और कंट्रोल की स्क्रिप्ट लिखता या अपडेट करता है, और सीधे Home Assistant में बना-बनाया Projector Pilot डैशबोर्ड भी तैयार करता है। जब भी कोई सीन जोड़ें या कंट्रोल बदलें, इसे फिर चलाएं - यह डुप्लिकेट जमा करने की बजाय उसी जगह अपडेट करता है।
• Remove orphaned scripts ऐप की लिखी वे स्क्रिप्ट ढूंढता है जिनका अब कोई मेल खाता सीन या कंट्रोल नहीं है - जैसे सीन हटाने के बाद - ठीक-ठीक बताता है कि कौन सी हटाएगा, और पहले पूछता है। आपके पुष्टि करने तक कुछ भी नहीं हटता। यह सिर्फ़ उन्हीं स्क्रिप्ट को छूता है जो Projector Pilot ने बनाई हैं; आपके Home Assistant में और कुछ नहीं छेड़ा जाता, और अगर Home Assistant अपनी स्क्रिप्ट की सूची नहीं देता, तो कुछ भी नहीं हटाया जाता।

• Home Assistant से कनेक्ट हो गया - साइन इन है और जवाब दे रहा है। अगर Home Assistant जवाब नहीं देता, तो पंक्ति कहती है कि पता जाँचें और देखें कि आपका फ़ोन उसी नेटवर्क पर है।
• प्रोजेक्टर Home Assistant में जोड़ा गया - क्या Home Assistant में यह प्रोजेक्टर पहले से है। अगर नहीं, तो पंक्ति आपको PJLink इंटीग्रेशन जोड़ने भेजती है, और इंटीग्रेशन जोड़ने का कदम वह PJLink होस्ट और पोर्ट दिखाता है जो Home Assistant मांगता है।
• रीडिंग सेंसर रजिस्टर हुआ - वह सेंसर जिसमें आपके प्रोजेक्टर की रीडिंग होती हैं। यह ऐप के प्रोजेक्टर को पहली बार पढ़ने पर रजिस्टर होता है, और जब कोई चीज़ इसे रोक रही हो तो पंक्ति अभी रजिस्टर करें या चालू करें देती है।
• आपके Home Assistant में क्या है - HACS (कम्युनिटी स्टोर), Epson Projector Link इंटीग्रेशन, PJLink इंटीग्रेशन, और configuration.yaml में Projector Pilot के कमांड। हर एक Found, Not installed या Could not tell दिखाता है, और जहाँ काम आए वहाँ How to install और Open in HACS बटन भी।

• पहले बिल्ट-इन कार्ड। अगर आपके पास कम्युनिटी कार्ड नहीं हैं, तो Sync आपका डैशबोर्ड Home Assistant के बिल्ट-इन कार्डों से बनाता है और खत्म होने पर यह बता देता है। यह बिना कुछ किए चलता है।
• HACS कार्ड इंस्टॉल हों तो अपग्रेड। ऐप जाँचता है कि कम्युनिटी कार्डों (Mushroom, button-card, card-mod, apexcharts-card) में से कौन से इंस्टॉल हैं, और जहाँ आपके पास हो वहाँ हर कार्ड को ज़्यादा समृद्ध वाले में अपग्रेड कर देता है। अगर आपको पूरा ग्रीन-ग्लास लुक चाहिए, तो हाथ से बनाने वाली डैशबोर्ड गाइड और आगे जाती है।
• सीन और कंट्रोल के लिए एक पेस्ट चाहिए। अगर Home Assistant में प्रोजेक्टर को भेजने का कमांड अभी नहीं है, तब भी डैशबोर्ड लाइव रीडिंग के साथ बन जाता है, और एक Finish setup कार्ड आपको आगे ले जाता है: Copy block पर टैप करें, उसे configuration.yaml में पेस्ट करें, Home Assistant रीस्टार्ट करें, फिर Sync पर दोबारा टैप करें।
• कुछ इंस्टॉल नहीं है? हाथ से पेस्ट करें। अगर Home Assistant में कुछ भी इंस्टॉल नहीं है, तब भी आप ऐप से सब कुछ कॉपी करके खुद पेस्ट कर सकते हैं।
• पासवर्ड की जानकारी साफ़ दी जाती है। आपके पेस्ट किए कमांड ब्लॉक में लिखा होता है कि उसमें प्रोजेक्टर का पासवर्ड है, ताकि शेयर या स्टोर करने से पहले आपको पता रहे।

• यह एक और वैकल्पिक ब्लॉक है: इसे configuration.yaml के अंत में पेस्ट करें (या मौजूदा template: सेक्शन के नीचे सिर्फ़ इसकी पंक्तियाँ जोड़ें) और Home Assistant रीस्टार्ट करें। ऐप में Check it is there बटन होता है जो बताता है कि Home Assistant में यह है या नहीं।
• पावर-ऑफ अब Home Assistant तक off के रूप में पहुंचता है, इसलिए डैशबोर्ड और आपके ऑटोमेशन प्रोजेक्टर को तब बंद देखते हैं जब वह बंद होता है।

• ऑटोमेशन उन्हें चला सकते हैं। “सूर्यास्त पर, अगर TV चालू हो, तो Movie Night चलाओ” एक सामान्य Home Assistant ऑटोमेशन है, एक बार सीन स्क्रिप्ट बन जाए।
• वॉइस असिस्टेंट उन्हें चला सकते हैं। अपने असिस्टेंट को कोई स्क्रिप्ट एक्सपोज़ करें, और “Movie Night चालू करो” इनपुट, पिक्चर मोड और लेंस मेमोरी एक साथ सेट कर देता है।
• सिर्फ़ आपके असली कंट्रोल दिखते हैं। ऐप प्रोजेक्टर के बताए हर इनपुट, कलर मोड और लेंस मेमोरी के लिए स्क्रिप्ट लिखता है - अंदाज़े से बनाई कोई आम सूची नहीं।
• सिंक हटाने पर सिर्फ़ वही हटता है जो ऐप ने लिखा था। सिंक बंद करें, या Remove orphaned scripts इस्तेमाल करें (जो उन्हें सूचीबद्ध करता है और पहले पूछता है), और Projector Pilot सिर्फ़ अपनी बनाई स्क्रिप्ट हटाता है, और कुछ नहीं।

डैशबोर्ड

Sync आपके लिए डैशबोर्ड बनाता है

आपको Lovelace व्यू हाथ से बनाने की ज़रूरत नहीं, और अब पेस्ट करने की भी नहीं। जब आप Sync With HA पर टैप करते हैं, ऐप अपने API से सीधे Home Assistant में पूरा Projector Pilot डैशबोर्ड बना देता है: प्रोजेक्टर की लाइव स्थिति और सिंक किए हर सीन व कंट्रोल के लिए एक बटन। वह आपके Home Assistant साइडबार में Projector Pilot नाम से दिखता है - उसे खोलें और काम खत्म।

1. ऐप में Home Assistant में साइन इन करें।
2. ऐप का Copy block एक बार configuration.yaml में पेस्ट करें और Home Assistant रीस्टार्ट करें (यही एक मैन्युअल कदम है - Home Assistant ऐप्स को वह कमांड दूर से जोड़ने नहीं देता)।
3. Sync With HA पर टैप करें। डैशबोर्ड आपके लिए बन जाता है और साइडबार में Projector Pilot नाम से दिखता है।

चाहे वह आपके लिए बना हो या आपने पेस्ट किया हो, डैशबोर्ड वही है - एक स्थिति कार्ड और हर कंट्रोल के लिए एक बटन (समझाने के लिए एक अंश):

views:
  - title: Projector
    cards:
      - type: entity
        entity: sensor.projector_pilot_epson_qb1000b_qb1000w
        name: Projector
      - type: button
        name: Power On
        tap_action:
          action: perform-action
          perform_action: script.turn_on
          target:
            entity_id: script.projector_pilot_power_on
      - type: button
        name: Movie Night
        tap_action:
          action: perform-action
          perform_action: script.turn_on
          target:
            entity_id: script.projector_pilot_scene_movie_night

सिर्फ़ उदाहरण। आपका डैशबोर्ड आपके प्रोजेक्टर की असली एंटिटी और आपके अपने सीन लेकर चलता है।

1. Hubitat में Maker API ऐप चालू करें, उसका एक्सेस URL और टोकन नोट करें, और चुनें कि वह कौन से डिवाइस एक्सपोज़ करे।
2. Projector Pilot में सेटिंग › होम ऑटोमेशन › Hubitat खोलें और अपने हब की Maker API जानकारी डालें।
3. वह डिवाइस चुनें जो प्रोजेक्टर का प्रतिनिधित्व करता है। ऐप संभावित डिवाइस सुझाता है; उसे चुनें या अपना चुनें।
4. ऐप उस डिवाइस पर पावर, म्यूट और इनपुट को मिरर करता है, और सिर्फ़ वही कमांड भेजता है जो डिवाइस स्वीकार करता है।
5. उस डिवाइस के खिलाफ़ Rule Machine नियम वैसे ही बनाएं जैसे किसी और के लिए बनाते - प्रोजेक्टर की स्थिति उन्हें चलाती है।

1. सेटिंग › होम ऑटोमेशन › वेबहुक खोलें।
2. जिस URL पर पोस्ट करना है वह डालें। Home Assistant वेबहुक ऐसा दिखता है: http://homeassistant.local:8123/api/webhook/your-id।
3. चुनें कि कौन से इवेंट वेबहुक चलाएं: पावर ऑन, पावर ऑफ, इनपुट बदलना, सीन चलाना - और चाहें तो किसी खास इनपुट या सीन तक फ़िल्टर करें।
4. अगर पाने वाली सेवा को कोई खास रूप चाहिए तो चाहें तो कस्टम पेलोड सेट करें; वरना ऐप अपना डिफ़ॉल्ट JSON भेजता है।
5. सेव करें। उसके बाद ऐप हर मेल खाते इवेंट पर पोस्ट करता है।

डिफ़ॉल्ट पेलोड सादा JSON है - एक इवेंट, प्रोजेक्टर, और जो वैल्यू बदली:

{
  "event": "scene_recalled",
  "projector": "Epson QB1000B/QB1000W",
  "scene": "Movie Night",
  "power": "on",
  "input": "HDMI1",
  "color_mode": "Cinema",
  "timestamp": "2026-09-23T20:14:07Z"
}

उदाहरण पेलोड। इनपुट बदलने या पावर वाले इवेंट में उससे जुड़े फ़ील्ड होते हैं।