Το CLI του MacWhisper: εγκατάσταση του mw, μεταγραφή από το Terminal και όλες οι επιλογές
Κείμενο: Ryleigh Newman · Δημοσιεύτηκε
Το MacWhisper συνοδεύεται από ένα εργαλείο γραμμής εντολών που λέγεται mw. Ελέγχει την εφαρμογή από το Terminal: μεταγράφει αρχεία και ολόκληρους φακέλους, ανιχνεύει ομιλητές, γράφει υπότιτλους ή JSON και εμφανίζει ή αλλάζει μοντέλα. Επικοινωνεί με την εφαρμογή MacWhisper που εκτελείται μέσω μιας τοπικής υποδοχής, οπότε χρησιμοποιεί τις μηχανές, τα μοντέλα και τις ρυθμίσεις που έχετε ήδη ορίσει, και ανοίγει την εφαρμογή αν δεν είναι ανοιχτή.
Αναπτύσσω το YapToText, μια διαφορετική εφαρμογή Mac για υπαγόρευση και μεταγραφή αρχείων, γι αυτό διαβάστε όσα λέω για το MacWhisper έχοντας το υπόψη. Κάθε στοιχείο για το MacWhisper εδώ προέρχεται από το άρθρο βοήθειάς του MacWhisper Command-Line Tool, όπως διαβάστηκε στις 10 Οκτωβρίου 2026.
Δωρεάν λήψη. Χωρίς λογαριασμό και χωρίς κλειδωμένες λειτουργίες, για macOS 14 ή μεταγενέστερο σε Mac με επεξεργαστή Apple. Πηγαίος κώδικας στο GitHub.
Αυτός ο οδηγός σε άλλες γλώσσες: English, العربية, Čeština, Dansk, Deutsch, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Σε αυτή τη σελίδα: 13 ενότητες
Εγκατάσταση του mw
- Ανοίξτε το MacWhisper, μετά το Settings (ρυθμίσεις) και μετά το Advanced (για προχωρημένους).
- Κάτω από το Command-Line Tool (εργαλείο γραμμής εντολών), κάντε κλικ στο Install (εγκατάσταση).
- Πληκτρολογήστε τον κωδικό του Mac σας αν τον ζητήσει το macOS. Χρειάζεται για να γραφτεί το εργαλείο στο /usr/local/bin.
- Ανοίξτε ένα νέο παράθυρο Terminal και εκτελέστε mw version.
Το εργαλείο εγκαθίσταται στο /usr/local/bin/mw και το παράθυρο ρυθμίσεων δείχνει ένα πράσινο σημάδι ελέγχου όταν ολοκληρωθεί η εγκατάσταση. Αν το mw version εμφανίσει έναν αριθμό έκδοσης, λειτουργεί. Για να το αφαιρέσετε, επιστρέψτε στο ίδιο παράθυρο και κάντε κλικ στο Uninstall (απεγκατάσταση).
Μεταγραφή ενός αρχείου
mw transcribe ~/Desktop/meeting.m4a
mw transcribe meeting.m4a > transcript.txt
mw transcribe meeting.m4a -o transcript.txt
mw transcribe meeting.m4a | pbcopyΤι συμβαίνει: Η μεταγραφή εκτυπώνεται στην τυπική έξοδο. Μια γραμμή προόδου πηγαίνει στο τυπικό σφάλμα, οπότε ένα αρχείο στο οποίο ανακατευθύνετε την έξοδο περιέχει μόνο τη μεταγραφή.
Από προεπιλογή, μια μεταγραφή από τη γραμμή εντολών δεν διατηρείται. Εκτυπώνεται και απορρίπτεται, και εμφανίζεται στο ιστορικό του MacWhisper μόνο αν προσθέσετε --persist. Το Ctrl+C σταματά μια εκτέλεση. Ένα υπάρχον αρχείο εξόδου δεν αντικαθίσταται ποτέ, εκτός αν προσθέσετε --overwrite.
Οι εντολές
Από το άρθρο βοήθειας του MacWhisper, όπως διαβάστηκε στις 10 Οκτωβρίου 2026. Προσθέστε --help σε οποιαδήποτε εντολή για να δείτε τις επιλογές της.
| Εντολή | Τι κάνει |
|---|---|
| mw | Μια συνοπτική εικόνα της κατάστασης: αν η εφαρμογή είναι προσβάσιμη, το επιλεγμένο μοντέλο, τα μοντέλα που έχουν ληφθεί και παραδείγματα εντολών |
| mw version | Εκτυπώνει την έκδοση του MacWhisper. Χρήσιμη ως έλεγχος σύνδεσης |
| mw models list | Εμφανίζει τα εγκατεστημένα μοντέλα μεταγραφής, με ένα αναγνωριστικό για καθένα |
| mw models select | Αλλάζει το ενεργό μοντέλο, τόσο στο εργαλείο γραμμής εντολών όσο και στην εφαρμογή |
| mw transcribe | Μεταγράφει αρχεία ήχου ή βίντεο, ή ολόκληρους φακέλους, και εκτυπώνει το κείμενο |
Επιλογές της εντολής mw transcribe
Από το ίδιο άρθρο. Μια γλώσσα που το επιλεγμένο μοντέλο δεν μπορεί να μεταγράψει οδηγεί σε σφάλμα.
| Επιλογή | Τι κάνει |
|---|---|
| --speakers, --no-speakers | Ενεργοποιεί ή απενεργοποιεί την ανίχνευση ομιλητών για αυτή την εκτέλεση. Όταν είναι ενεργή, η μεταγραφή ομαδοποιείται ανά ομιλητή |
| --format | txt, που είναι η προεπιλογή, ή srt, vtt, json, csv, md, html ή avid |
| --style | transcript, subtitles ή segments, τα ίδια στιλ με το πάνελ Export της εφαρμογής |
| --model | Χρησιμοποιεί ένα μοντέλο για αυτή την εκτέλεση χωρίς να αλλάξει την επιλογή της εφαρμογής |
| --language | Ένας κωδικός ISO, όπως en ή de, ή auto, ή multilingual |
| --output, -o | Γράφει τη μεταγραφή σε ένα αρχείο |
| --output-dir | Λειτουργία παρτίδας. Γράφει μία μεταγραφή για κάθε αρχείο εισόδου σε έναν φάκελο |
| --recursive | Συμπεριλαμβάνει τους υποφακέλους όταν δίνετε έναν φάκελο |
| --stream | Εκτυπώνει τα τμήματα καθώς ολοκληρώνονται. Μόνο με τοπικές μηχανές |
| --persist | Διατηρεί τη μεταγραφή στο ιστορικό του MacWhisper |
| --timestamps, --milliseconds, --group, --max-chars-per-line, --fps | Ρυθμίζουν με λεπτομέρεια τη διάταξη |
Μορφές, και ποιες απαιτούν Pro
Από το ίδιο άρθρο. Η σελίδα τιμών του MacWhisper εξηγεί πόσο κοστίζει το Pro.
| Μορφή | Τι παίρνετε | Άδεια |
|---|---|---|
| txt | Απλό κείμενο | Όλοι |
| srt | Υπότιτλοι SubRip | Όλοι |
| vtt | Υπότιτλοι WebVTT | Όλοι |
| csv | Γραμμές με αρχή, τέλος και μεταγραφή, και ομιλητή όταν ανιχνεύεται | Όλοι |
| json | Χρονοσημάνσεις σε χιλιοστά του δευτερολέπτου, ομιλητές ανά τμήμα και χρονισμούς λέξεων | Pro |
| md | Markdown με μπλοκ που έχουν χρονοσήμανση και επικεφαλίδες ομιλητών | Pro |
| html | Ένα αυτόνομο έγγραφο HTML | Pro |
| avid | Κείμενο υποτίτλων Avid με χρονοκώδικες SMPTE | Pro |
Ολόκληροι φάκελοι
mw transcribe ~/Recordings --recursive --output-dir ~/Transcripts
mw transcribe ~/Videos --output-dir ~/Subs --format srt
mw transcribe interview.m4a --speakers -o interview.txtΤι συμβαίνει: Κάθε αρχείο εισόδου παίρνει το δικό του αρχείο εξόδου, με το ίδιο όνομα, και η δομή των φακέλων αντιγράφεται. Ένα αρχείο που αποτυγχάνει αναφέρεται και παραλείπεται, και η εκτέλεση συνεχίζεται.
Η ανίχνευση ομιλητών χρειάζεται ένα μοντέλο που τη στηρίζει. Η σελίδα για την αναγνώριση ομιλητών καλύπτει αυτή την πλευρά της εφαρμογής.
Όταν δεν λειτουργεί
- mw: command not found. Ανοίξτε ένα νέο παράθυρο Terminal ή προσθέστε το /usr/local/bin στο PATH σας.
- Κολλάει. Κλείστε και ανοίξτε ξανά το MacWhisper και δοκιμάστε πάλι το mw version.
- Δεν αναγνωρίζεται ένα αναγνωριστικό μοντέλου. Εκτελέστε mw models list για τα ακριβή αναγνωριστικά και κατεβάστε πρώτα το μοντέλο στην εφαρμογή.
- Σφάλμα Pro σε μια μορφή. Οι μορφές json, md, html και avid απαιτούν άδεια Pro.
- Σφάλμα sandbox. Ένα πρόγραμμα που εκτελείται σε sandbox, μαζί με ορισμένα εργαλεία προγραμματισμού με ΤΝ, μπορεί να μπλοκάρεται από την υποδοχή του MacWhisper. Εκτελέστε το mw απευθείας στο Terminal.
Η σελίδα αντιμετώπισης προβλημάτων του MacWhisper καλύπτει την ίδια την εφαρμογή.
Δωρεάν επιλογές από το Terminal
Το YapToText δεν έχει εργαλείο γραμμής εντολών. Μεταγράφει ένα αρχείο που σύρετε πάνω του, ένα κάθε φορά, σε απλό κείμενο, δωρεάν. Αν θέλετε Terminal και τίποτα να μην πληρώνετε, το whisper.cpp είναι ανοιχτού κώδικα και είναι η μηχανή πάνω στην οποία είναι χτισμένο το YapToText. Ο οδηγός για το τοπικό Whisper έχει τις εντολές, και η σελίδα για το λογισμικό μεταγραφής ανοιχτού κώδικα συγκρίνει τέσσερα δωρεάν εργαλεία.
Δωρεάν λήψη. Χωρίς λογαριασμό και χωρίς κλειδωμένες λειτουργίες, για macOS 14 ή μεταγενέστερο σε Mac με επεξεργαστή Apple. Πηγαίος κώδικας στο GitHub.
Η σύντομη εκδοχή
- Εγκατάσταση. Settings, Advanced, Command-Line Tool, Install.
- Εκτέλεση. Η εντολή mw transcribe και μετά ένα αρχείο ή ένας φάκελος.
- Δωρεάν μορφές. Οι txt, srt, vtt και csv.
- Μορφές Pro. Οι json, md, html και avid.
- Ιστορικό. Τίποτα δεν διατηρείται αν δεν προσθέσετε --persist.
Αν το MacWhisper αλλάξει το εργαλείο και αυτή η σελίδα μείνει πίσω, ανοίξτε ένα θέμα στο GitHub. Διαβάζονται όλα.
Δωρεάν λήψη. Χωρίς λογαριασμό και χωρίς κλειδωμένες λειτουργίες, για macOS 14 ή μεταγενέστερο σε Mac με επεξεργαστή Apple. Πηγαίος κώδικας στο GitHub.
Οδηγοί
Περισσότεροι οδηγοί, στα αγγλικά
Πηγές
- https://docs.macwhisper.com/article/57-macwhisper-command-line-tool (ελέγχθηκε 10/10/2026)
- https://github.com/ryleighnewman/YapToText (ελέγχθηκε 10/10/2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (ελέγχθηκε 10/10/2026)
Ερωτήσεις
Έχει το MacWhisper εργαλείο γραμμής εντολών;
Ναι. Λέγεται mw και το εγκαθιστάτε από τις ρυθμίσεις του MacWhisper (Settings), στο Advanced, Command-Line Tool.
Πώς μεταγράφω ένα αρχείο με το MacWhisper από το Terminal;
Εκτελέστε mw transcribe και μετά τη διαδρομή του αρχείου. Η μεταγραφή εκτυπώνεται στην τυπική έξοδο, ή σε ένα αρχείο με το -o.
Είναι δωρεάν το CLI του MacWhisper;
Το άρθρο βοήθειάς του λέει ότι οι έξοδοι txt, srt, vtt και csv είναι διαθέσιμες σε όλους, και ότι οι json, md, html και avid απαιτούν άδεια Pro.
Μπορεί το CLI του MacWhisper να μεταγράψει ολόκληρο φάκελο;
Ναι. Δώστε έναν φάκελο στο mw transcribe, προσθέστε --recursive για τους υποφακέλους και --output-dir για να γράφεται μία μεταγραφή ανά αρχείο.
Χρειάζεται το mw να είναι ανοιχτό το MacWhisper;
Επικοινωνεί με την εφαρμογή που εκτελείται και ανοίγει αυτόματα το MacWhisper αν δεν είναι ανοιχτό.