Berth वापरकर्ता मार्गदर्शक

SFTP · टर्मिनल · सिरियल कन्सोल एकाच विंडोत — सर्व्हर जोडण्यापासून शॉर्टकट कीपर्यंत

🚀सुरुवात करणे

स्क्रीन रचना

एका विंडोत चार भाग आहेत.

साइट साइडबार — डावीकडे. सर्व्हर·सिरियल कन्सोल आणि फोल्डर ट्रीच्या स्वरूपात आहेत.
सत्र स्तंभ — कनेक्ट झालेली सत्रे. रंगाच्या पट्टीने कोणता सर्व्हर आहे ते ओळखले जाते.
वर्कस्पेस — वर फाइल पॅनेल (लोकल·रिमोट), खाली टर्मिनल आहे. विभाजक रेषा ओढून प्रमाण बदलता येते.
स्टेटस बार — सर्वात खाली. सध्या काय घडते आहे ते सांगते.

पहिला सर्व्हर जोडणे

साइडबारच्या रिकाम्या जागी उजवे क्लिक करा किंवा ⌘N दाबा.
नाव आणि सर्व्हर पत्ता टाका. युजर·पोर्ट रिकामे ठेवल्यास डीफॉल्ट मूल्य वापरले जाते.
यादीत दोनदा क्लिक केल्यास कनेक्ट होते. एकदा क्लिक म्हणजे निवडणे.

💡 आधीच टर्मिनलमध्ये ssh aliasने कनेक्ट होणारा सर्व्हर असेल, तर नव्याने काही टाकण्याची गरज नाही. साइडबार मेनूमधील ~/.ssh/config मधून आयात करा(⌘⇧I) ने एकाच वेळी आणता येते. FileZilla साइट यादीदेखील आयात करता येते.

भाषा बदलणे

मेनूमधील Berth › सेटिंग्ज(⌘,) मधून 20 भाषांपैकी एक निवडा. सिस्टीम भाषा फॉलो करणे हे डीफॉल्ट आहे, आणि निवडलेली भाषा फक्त या अॅपला लागू होते. बदलल्यानंतर अॅप पुन्हा सुरू केल्यावर लागू होते.

🗂सर्व्हर आणि फोल्डर

फोल्डरमध्ये गटबद्ध करून वारसा देणे

फोल्डर(⌘⇧N) मध्ये सर्व्हर एकत्र गटबद्ध केल्यास सेटिंग्ज खाली उतरतात. फोल्डरला एकदा युजरनेम किंवा सावधानता श्रेणी लावली की त्याखालील सर्व सर्व्हर तीच पाळतात. वीस सर्व्हरना एकच मूल्य वीस वेळा टाकावे लागू नये यासाठी असलेली सोय आहे.

सेटिंग्ज विंडोतील प्रत्येक चौकट त्या मूल्याचे मूळ काय आहे (मी ठरवले की एखाद्या फोल्डरकडून वारशाने मिळाले) हे खाली दाखवते, आणि परत जाण्याच्या बटणाने वारशाकडे परत जाता येते.

सावधानता श्रेणी — डेव्हलपमेंट · स्टेजिंग · प्रॉडक्शन

स्तर रंगापेक्षा वरचढ आहे. प्रॉडक्शन ठेवल्यास धोकादायक क्रियांआधी अधिक खात्री विचारली जाते. सत्र यादीत ते तुम्ही निवडलेल्या रंगाने भरले जाते आणि लाल कडेने दर्शवले जाते, त्यामुळे अनेक प्रॉडक्शन सर्व्हर रंगाने ओळखता येतात. जिथे एका वेळी एकच दिसते (खात्री संवाद वगैरे), तिथे ते तीव्र इशाऱ्यासाठी लाल राहते.

क्लिक नियम

एकदा — निवडणे (सेटिंग्ज पाहण्यासाठी किंवा हलवण्यासाठी दाबणे)
दोनदा — सर्व्हरसाठी कनेक्ट, फोल्डरसाठी विस्तृत/संकुचित करणे
फोल्डरसमोरील त्रिकोण एकदा दाबल्यास विस्तृत होतो.

🔑कनेक्शन आणि प्रमाणीकरण

पहिल्यांदा कनेक्ट करताना — फोल्डर परवानगी

Berth हा App Store चा नियम (सँडबॉक्स) पाळत असल्याने होम फोल्डर मनाप्रमाणे वाचत नाही. पहिल्यांदा सर्व्हर उघडताना SSH सेटिंग्ज·की·known_hosts असलेला फोल्डर (सहसा ~/.ssh) एकदा निवडायला सांगतो. एकदा निवडल्यावर तो लक्षात ठेवला जातो आणि पुन्हा विचारले जात नाही. की दुसऱ्या ठिकाणी ठेवली असल्यास होम फोल्डर निवडला तरी चालते.

लोकल फाइल पॅनेलदेखील याच कारणामुळे तुम्ही निवडलेला फोल्डर मूळ म्हणून वापरतो — पॅनेलच्या शीर्षकातील लोकल फोल्डर उघडा ने बदलता येतो, आणि हेदेखील लक्षात ठेवले जाते.

~/.ssh/config वाचतो

अलियासने कनेक्ट केल्यास त्या नोंदीतील होस्ट·पोर्ट·युजर·की फाइल·ProxyJump· StrictHostKeyChecking वाचून वापरले जाते. जतन केलेला पोर्ट जुना असला तरी सेटिंग्ज फाइल वरचढ ठरते.

⚠️ दोन गोष्टी होत नाहीत. ProxyCommand हे बाह्य प्रोग्राम सुरू करणारे कार्य असल्याने सँडबॉक्समध्ये अडवले जाते — जंप होस्टसाठी ProxyJump वापरा. ssh-agent पर्यंतही पोहोचता येत नाही, त्यामुळे की फाइल थेट वाचली जाते आणि पासवर्ड असलेल्या कीसाठी कनेक्ट करताना पासवर्ड विचारला जातो.

प्रमाणीकरण पद्धत

आपोआप — ssh वर सोपवले जाते. सर्व डीफॉल्ट की वापरून पाहतो, न जमल्यास टर्मिनलमध्ये पासवर्ड विचारतो.
की फाइल — निवडलेली एकच की वापरते.
पासवर्ड — की वगळली जाते.

⚠️ टर्मिनलमध्ये नुसत्या sshने कनेक्ट होणारा सर्व्हर असेल, तर आपोआप हाच योग्य पर्याय आहे. मदत होईल म्हणून की निवडल्यास उलट कनेक्शन अडते — कारण फक्त निवडलेली एकच की वापरून पाहिली जाते.

सर्व्हर विचारतो तेव्हा

पासवर्ड जतन करून ठेवल्यास कनेक्ट करताना एकदा तो आपोआप दिला जातो. इतर प्रश्न — द्वि-घटक प्रमाणीकरण कोड, चुकीचा पासवर्ड पुन्हा टाकणे, पासवर्ड असलेल्या कीचा पासवर्ड — यांसाठी "सर्व्हरकडून विनंती आली आहे" विंडोत सर्व्हरने पाठवलेला प्रश्न जसाच्या तसा दिसतो आणि तो स्वतः उत्तरावा लागतो. खाते लॉक होऊ नये म्हणून जतन केलेला पासवर्ड फक्त एकदाच आपोआप टाकला जातो, आणि जास्तीत जास्त तीन वेळाच विचारले जाते.

पासवर्ड पुन्हापुन्हा टाकणे थांबवायचे असल्यास

सर्व्हरवर उजवे क्लिक करून या सर्व्हरवर सार्वजनिक की नोंदणी… निवडल्यास ~/.ssh मधील सार्वजनिक की सर्व्हरवर अपलोड केली जाते. यापुढे कीने कनेक्ट होईल.

जतन केलेला पासवर्ड फक्त macOS की-चेनमध्येच असतो. सेटिंग्ज फाइलमध्ये फक्त "जतन केलेले आहे" अशी खूण राहते, मूल्य त्यात नसते.

प्रथमच दिसणारा सर्व्हर, बदललेली होस्ट की

पहिल्यांदा कनेक्ट होणारा सर्व्हर कीचा प्रकार आणि फिंगरप्रिंट दाखवून लक्षात ठेवायचे का विचारतो. लक्षात ठेवल्यास ~/.ssh/known_hosts मध्ये ssh प्रमाणेच नोंद केली जाते आणि यापुढे विचारले जात नाही.

सर्व्हरची ओळख आधीच्या वेळेपेक्षा वेगळी असते तेव्हाही हे दिसते. मॅन-इन-द-मिडल हल्ला असू शकतो, किंवा सर्व्हर पुन्हा इन्स्टॉल केला असू शकतो. Berth स्वतः निर्णय न घेता आवश्यक माहिती देतो — जुन्या/नव्या कीचा प्रकार आणि फिंगरप्रिंट, आणि उपकरणाच्या कन्सोलवरून थेट पडताळण्याची कमांडदेखील. खात्री केल्यानंतर "जुनी की काढून नवी की लक्षात ठेवा" दाबल्यास जुनी नोंद काढली जाते (known_hosts.old मध्ये बॅकअप) आणि नवी की लिहिली जाते.

💡 वारंवार पुन्हा फ्लॅश केल्या जाणाऱ्या डेव्हलपमेंट बोर्डसारख्या प्रत्येक वेळी ही विंडो दिसणाऱ्या उपकरणासाठी, त्या सर्व्हरच्या सेटिंग्जमध्ये होस्ट की लक्षात ठेवू नका सुरू करता येते. धोका फक्त त्या एका उपकरणापुरता राहावा म्हणून known_hosts ला हात लावला जात नाही. प्रॉडक्शन श्रेणीत हे सुरू करता येत नाही.

फाइल पॅनेल (SFTP)

अपलोड आणि डाउनलोड करणे

डावीकडे तुमचा मॅक, उजवीकडे सर्व्हर. ओढून सोडा किंवा ⌥⌘→(अपलोड) · ⌥⌘←(डाउनलोड) ने पाठवा. प्रगती ट्रान्सफर रांगेत साठत जाते.

टर्मिनलला फॉलो करणारे फाइल पॅनेल

टर्मिनलमध्ये cd केल्यास रिमोट पॅनेल त्याच फोल्डरला फॉलो करतो. फॉलो करणे अडथळा वाटल्यास ⌘⇧L ने बंद करा.

वारंवार जाण्याची ठिकाणे · दृश्य

⌘D — सध्याचा मार्ग पिनला लावतो किंवा काढतो. पिन हा ट्रीचे मूळ बनतो.
⌘↓ — निवडलेल्या फोल्डरमध्ये खोलवर जाते. ⌘↑ ने एक टप्पा मागे जाते.
⌥⌘T — ट्री ↔ यादी दृश्य. हजारो फाइल असलेल्या फोल्डरसाठी यादी दृश्य चांगले असते.
⌘R — पुन्हा वाचा.
⌘⇧F — सर्व्हरवर शोधा. अॅप यादी चाळत नाही तर सर्व्हरवर find चालतो.

फरक पाहणे

⌘⇧Y ने सुरू केल्यास लोकल आणि रिमोट शेजारी-शेजारी ताडून वेगळे असलेले·फक्त एकाच बाजूला असलेले दाखवले जाते. गरजेचेच पाठवायचे असताना वापरतात.

🌏 मॅक आणि लिनक्स कोरियन·जपानी·व्हिएतनामी फाइलनावे वेगळ्या बाइट्समध्ये लिहितात. Berth जोडी जुळवतानाच नावे ताडून पाहतो, त्यामुळे दिसायला सारखी असलेली फाइल "फक्त एकाच बाजूला आहे" असे विभागली जात नाही. प्रत्यक्ष ट्रान्सफरमध्ये सर्व्हरवर असलेले नाव जसेच्या तसे वापरले जाते.

काढणे

⌘⌫ हे डीफॉल्टने सर्व्हरच्या ट्रॅशमध्ये हलवते आणि नेहमी खात्री विचारते. ट्रॅश बंद असलेल्या सर्व्हरवर पूर्ववत करता येणार नाही असे आधीच सांगितले जाते.

⌨️टर्मिनल

vim·tmux·less जसेच्या तसे चालणारे खरे शेल आहे. माउसने ओढून निवडा आणि ⌘C ने कॉपी करा — कमांड ओळीच्या शेवटच्या फालतू रिकाम्या जागेशिवाय स्वच्छपणे चिकटते.

चिकटवण्याची खात्री

अनेक ओळी चिकटवल्यास काय एक्झिक्युट होणार आहे ते आधी दाखवले जाते. ओळ-बदल असलेले चिकटवणे तिथल्या तिथे कमांड बनून जाते म्हणून. धोकादायक वाटणारे कारणासहित दाखवले जाते.

मोठे करून पाहणे

⌘↩ ने सध्याचा भाग मोठा करा आणि पुन्हा दाबून परत या. ⌥⌘↩ फक्त एकच पॅनेल मोठा करतो. अक्षर आकारासाठी ⌘+ · ⌘- · ⌘0 वापरा. टर्मिनल ⌘L ने साफ करा — स्क्रीन आणि स्क्रोलबॅक पुसले जाते, फक्त सध्याची प्रॉम्प्ट ओळ राहते.

🔌सिरियल कन्सोल (UART)

डिव्हाइस निवडणे

⌃⌘N ने सिरियल कन्सोल जोडा, आणि सेटिंग्जमध्ये जोडलेले डिव्हाइस निवडा. Berth मार्ग नव्हे तर डिव्हाइस लक्षात ठेवतो — सिरियल नंबर असल्यास त्याने, नसल्यास प्रकाराने. वेगळ्या USB जागी जोडले तरी तेच डिव्हाइस शोधले जाते.

💡 तो सिरियल नंबर USB म्हणून सूचीबद्ध होणाऱ्या गोष्टीचा असतो. USB-सिरियल अडॅप्टर वापरल्यास अडॅप्टर लक्षात ठेवला जातो, त्यामुळे अडॅप्टर बदलल्यास पुन्हा निवडावा लागतो.

वेग आणि लाइन सेटिंग्ज

वेग यादीतून निवडा किंवा थेट टाका (1,500,000 सारखे प्रमाणाबाहेरील मूल्यही चालते — फक्त अडॅप्टर स्वीकारणारे मूल्य असावे). डीफॉल्ट 8N1 · फ्लो नियंत्रण नाही असून, बहुतेक कन्सोल याच मूल्यावर असतात.

फ्लो नियंत्रण — 4-वायर केबल (RTS/CTS) वापरतानाच सुरू करा. 3-वायर केबलवर सुरू केल्यास उलट अडते.
प्रगत (पॅरिटी · बिट) — ओळ दाबून विस्तृत करा. STM32 बूटलोडर (8E1) सारखे वेगळे असेल तेव्हाच वापरा.

⚠️ फ्लो नियंत्रण नसलेल्या UART मध्ये सलग·मोठ्या प्रमाणातील संदेशवहनात डिव्हाइस पाठवणे थांबवण्याचा प्रकार घडू शकतो. हा फक्त या अॅपचा प्रश्न नसून केबलच्याच वैशिष्ट्यामुळे होतो (त्याच केबलवर इतर प्रोग्राम्समध्येही तेच घडते), मूळ उपाय म्हणजे 4-वायर केबलमध्ये फ्लो नियंत्रण सुरू करणे किंवा बोर्डकडील वेग कमी करणे.

नोंद पॅनेल

सिरियल सत्रात तुम्ही टाकलेली कमांड आणि तिचे उत्तर वेळेसह उजवीकडे साठत जाते. पासवर्ड विचारलेल्या जागी टाकलेला मजकूर लपवला जातो.

⚡शॉर्टकट की

अॅपच्या शॉर्टकट कीमध्ये नेहमी ⌘ असते. ⌃·⌥ संयोजन शेल आणि TUI (vim·tmux) साठी असतात, त्यामुळे अॅप ती घेत नाही.

⌨️ माउसची गरज नाही. इथल्या प्रत्येक कृतीसाठी शॉर्टकट आहे — ज्यांना हात कीबोर्डवरच ठेवायचा आहे त्यांच्यासाठी.

की	काय करते
`⌘N` · `⌃⌘N` · `⌘⇧N`	सर्व्हर जोडा · सिरियल कन्सोल जोडा · फोल्डर तयार करा
`⌘I` · `⌘⇧I`	या सर्व्हरची सेटिंग्ज · ~/.ssh/config मधून आयात करा
`⌘K`	कुठे जायचे — नावाने शोधून थेट जा
`⌘1` … `⌘9`	सत्र बदला
`⌃⌘←` `→` `↑` `↓`	पॅनेलदरम्यान हलवा
`⌘↩` · `⌥⌘↩`	मोठे करा / मूळस्थितीत आणा · फक्त हा पॅनेल मोठा करा
`⌘⇧S` · `⌥⌘↑` `⌥⌘↓`	साइडबार · विभाजक रेषा हलवा
`⌥⌘→` · `⌥⌘←`	अपलोड · डाउनलोड
`⌘D` · `⌘R` · `⌥⌘N`	पिन लावा/काढा · पुन्हा वाचा · नवीन फोल्डर
`⌘↓` · `⌘↑` · `⌥⌘T`	खोलवर जा · मागे जा · ट्री↔यादी
`⌘⌫` · `⌘⇧F`	रिमोटवरून काढा · सर्व्हरवर शोधा
`⌘⇧V` · `⌘⇧L` · `⌘⇧Y`	मार्ग टर्मिनलमध्ये · टर्मिनल फॉलो करणे · फरक दाखवणे
`⌘+` `⌘-` `⌘0` · `⌘⇧W`	अक्षर आकार · हे सत्र बंद करा
`⌘L` · `⌘]` `⌘[`	टर्मिनल साफ करा · उजव्या पॅनेलचे टॅब बदला
`⌘C` · `⌘⇧P` · `⌘⇧U` · `⌘?`	कॉपी · रेकॉर्डमध्ये ठेवा · मॅनिफेस्ट पुन्हा पाठवा · वापर मार्गदर्शक

❓वारंवार विचारले जाणारे प्रश्न

पासवर्ड कुठे जतन केला जातो?

फक्त macOS की-चेनमध्ये जतन केले जाते. सेटिंग्ज फाइलमध्ये फक्त "जतन केलेले आहे" अशी खूण राहते. की-चेन कनेक्ट होताना फक्त एकदाच उघडली जाते.

वापराची नोंद गोळा केली जाते का?

नाही. अॅपमध्ये कोणतेही ट्रॅकिंग नाही. काय उघडले जाते, कुठे कनेक्ट होते हे मोजले जात नाही.

सिरियल कन्सोल मध्येच थांबतो.

फ्लो नियंत्रण नसलेल्या UART मध्ये मोठ्या प्रमाणात संदेशवहन केल्यास होणारे केबलचे वैशिष्ट्य आहे. 4-वायर केबल असल्यास सेटिंग्जमध्ये फ्लो नियंत्रण (RTS/CTS) सुरू करा, आणि 3-वायर असल्यास बोर्डकडील वेग कमी करा किंवा आउटपुट टप्प्याटप्प्याने विभागून पाहा.

आधीपासून वापरत असलेली SSH सेटिंग्ज पुन्हा टाकावी लागते का?

नाही. ~/.ssh/config मधून आयात केल्यास अलियास तसाच वापरून कनेक्ट होते, आणि त्या नोंदीतील होस्ट·पोर्ट· युजर·की·ProxyJump वाचून वापरले जाते.

ProxyCommand वापरणारी सेटिंग आहे.

ProxyCommand हे बाह्य प्रोग्राम सुरू करणारे कार्य असल्याने App Store च्या सँडबॉक्समध्ये वापरता येत नाही. जंप होस्टमार्गे जाणारी सेटिंग असल्यास ProxyJump मध्ये बदलल्यास तसेच काम होते. ssh-agent देखील याच कारणामुळे वापरता येत नाही, की फाइल थेट वाचली जाते आणि पासवर्ड असलेल्या कीसाठी कनेक्ट करताना पासवर्ड विचारला जातो.

समर्थित macOS आवृत्ती कोणती?

macOS 14 (Sonoma) किंवा त्यावरील आवृत्ती, Apple Silicon आणि Intel दोन्हीवर चालते.

उपयोगी वाटले असल्यास

Berth मोफत आहे. देणगी द्या ने विकासाला हातभार लावता येतो.