scribe-cli 0.7.11__tar.gz → 0.9.0__tar.gz

{scribe_cli-0.7.11/scribe_cli.egg-info → scribe_cli-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: scribe-cli
-Version: 0.7.11
+Version: 0.9.0
 Summary: scribe is a local speech recognition tool that provides real-time transcription using vosk and whisper AI, with the goal of serving as a virtual keyboard on a computer
 Author-email: Mahé Perrette <mahe.perrette@gmail.com>
 License: MIT License
@@ -118,7 +118,7 @@ scribe
 and the script will guide you through the choice of backend (`whisper` or `vosk`) and the specific language model.
 After this, you will be prompted to start recording your microphone and print the transcribed text in real-time (`vosk`)
 or until after recording is complete (`whisper`).
-You can interrupt the recording via Ctrl + C and start again or change model. The full content of the transcription will be pasted to the clipboard by default, until interruption.
+You can interrupt the recording via Ctrl + C and start again or change model.
 
 The default (`whisper`) is excellent at transcribing a full-length audio sequences in [many languages](https://github.com/openai/whisper?tab=readme-ov-file#available-models-and-languages). It is really impressive,
 but it cannot do real-time, and depending on the model can have relatively long execution time, especially with the `turbo` model (at least on my laptop with CPU only). The `small` model is also excellent and runs much faster. It is selected as default in `scribe` for that reason.
@@ -135,19 +135,38 @@ scribe --backend whisper --model small --no-prompt
 ```
 where `--no-prompt` jumps right to the recording (after the first interruption, you can still choose to change the backend and model).
 
-### Virtual keyboard (experimental)
+## Output media
+
+By default the transcription is printed on the terminal, but other output media are supported.
+
+### Clipboard
+
+The most straightforward is the clipboard:
+
+```bash
+scribe --clipboard
+```
+The content of the (full) transcription is then pasted to the clipboard, and it is up to the user to paste (e.g. Ctrl + V).
 
-By default the content of the transcription is pasted to the clipboard, and it is up to the user to paste (e.g. Ctrl + V).
-However with the `vosk` backend and its realtime transcription, it is very handy to have the keys sent directly to the keyboard.
-That can be achieve with the `--keyboard` option.
+### Output file
 
-With the `--keyboard` option `scribe` will attempt to simulate a keyboard and send transcribed characters to the applcation under focus:
+Alternatively an output file can be indicated:
+
+```bash
+ --keyboard -o transcription.txt
+```
+
+### Virtual keyboard (experimental)
+
+With the `--keyboard` option `scribe` will attempt to simulate a keyboard and send transcribed characters to the application under focus:
 
 ```bash
 scribe --keyboard
 ```
 
-It relies on the optional `pynput` dependency (installed together with `scribe` if you used the `[all]` or `[keyboard]` option).
+This can be extremely useful with the `vosk` backend and its realtime transcription, or alternatively with the `--restart` option with the `whisper` backend.
+
+The `--keyboard` option relies on the optional `pynput` dependency (installed together with `scribe` if you used the `[all]` or `[keyboard]` option).
 Depending on your operating system, `pynput` may require additional configuration to work around its [limitations](https://pynput.readthedocs.io/en/latest/limitations.html).
 
 #### Use the keyboard with Wayland (default for Ubuntu 24.04)
@@ -164,7 +183,7 @@ sudo HOME=$HOME XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR PYNPUT_BACKEND_KEYBOARD=uinput
 ```
 You're on the right path :)
 
-### System tray icon (experimental) <img src="scribe_data/share/icon.png" width=48px>
+## System tray icon (experimental) <img src="scribe_data/share/icon.png" width=48px>
 
 To avoid switching back and forth with the terminal, it's possible to interact with the program via an icon tray.
 To activate start with:
@@ -179,15 +198,30 @@ sudo apt install libcairo-dev libgirepository1.0-dev gir1.2-appindicator3-0.1
 pip install PyGObject
 ```
 
-### Start as an application in GNOME
+## Start as an application in GNOME
 
 If you run Ubuntu (or else?) with GNOME, the script `scribe-install [...]` will create a `scribe.desktop` file and place it under `$HOME/.local/share/applications`
-to make it available from the quick launch menu. Any option will be passed on to `scribe`.
+to make it available from the quick launch menu. Any option will be passed on to `scribe`, with the additional options `--name` and `--no-terminal`.
+`--no-terminal` means no terminal will show up, and it also implies the options `--app --no-prompt`.
 
 e.g.
 
 ```bash
-scribe-install --backend whisper --model small
+scribe-install
+scribe-install --name "Scribe Whisper" --backend whisper --model small --clipboard --restart-after-silence --no-prompt
+scribe-install --name "Scribe Vosk FR" --backend vosk --language fr --keyboard --clipboard --no-terminal
 ```
+This will install three separate apps:
+- `Super + scribe` : will launch the default version with terminal prompt
+- `Super + whisper` : will launch a present version with the `small` model from `whisper` and start recording right away. You can see what is going on in the terminal and the result is ready to paste from the clipboard
+- `Super + vosk fr` : will launch a preset version for real-time transcription in French with the `vosk` backend, and throughput to the clipboard and the keyboard, not even opening a terminal.
+
 
-After that just typing Cmd + scri... at any time from any where will conveniently start the app in its own terminal with the prescribed options.
+## Fine tuning
+
+There are a number of options to control the silence threshold, duration and more.
+Best is to check the available options in the online help:
+
+```bash
+scribe --help
+```

{scribe_cli-0.7.11 → scribe_cli-0.9.0}/README.md

@@ -55,7 +55,7 @@ scribe
 and the script will guide you through the choice of backend (`whisper` or `vosk`) and the specific language model.
 After this, you will be prompted to start recording your microphone and print the transcribed text in real-time (`vosk`)
 or until after recording is complete (`whisper`).
-You can interrupt the recording via Ctrl + C and start again or change model. The full content of the transcription will be pasted to the clipboard by default, until interruption.
+You can interrupt the recording via Ctrl + C and start again or change model.
 
 The default (`whisper`) is excellent at transcribing a full-length audio sequences in [many languages](https://github.com/openai/whisper?tab=readme-ov-file#available-models-and-languages). It is really impressive,
 but it cannot do real-time, and depending on the model can have relatively long execution time, especially with the `turbo` model (at least on my laptop with CPU only). The `small` model is also excellent and runs much faster. It is selected as default in `scribe` for that reason.
@@ -72,19 +72,38 @@ scribe --backend whisper --model small --no-prompt
 ```
 where `--no-prompt` jumps right to the recording (after the first interruption, you can still choose to change the backend and model).
 
-### Virtual keyboard (experimental)
+## Output media
+
+By default the transcription is printed on the terminal, but other output media are supported.
+
+### Clipboard
+
+The most straightforward is the clipboard:
+
+```bash
+scribe --clipboard
+```
+The content of the (full) transcription is then pasted to the clipboard, and it is up to the user to paste (e.g. Ctrl + V).
+
+### Output file
+
+Alternatively an output file can be indicated:
 
-By default the content of the transcription is pasted to the clipboard, and it is up to the user to paste (e.g. Ctrl + V).
-However with the `vosk` backend and its realtime transcription, it is very handy to have the keys sent directly to the keyboard.
-That can be achieve with the `--keyboard` option.
+```bash
+ --keyboard -o transcription.txt
+```
 
-With the `--keyboard` option `scribe` will attempt to simulate a keyboard and send transcribed characters to the applcation under focus:
+### Virtual keyboard (experimental)
+
+With the `--keyboard` option `scribe` will attempt to simulate a keyboard and send transcribed characters to the application under focus:
 
 ```bash
 scribe --keyboard
 ```
 
-It relies on the optional `pynput` dependency (installed together with `scribe` if you used the `[all]` or `[keyboard]` option).
+This can be extremely useful with the `vosk` backend and its realtime transcription, or alternatively with the `--restart` option with the `whisper` backend.
+
+The `--keyboard` option relies on the optional `pynput` dependency (installed together with `scribe` if you used the `[all]` or `[keyboard]` option).
 Depending on your operating system, `pynput` may require additional configuration to work around its [limitations](https://pynput.readthedocs.io/en/latest/limitations.html).
 
 #### Use the keyboard with Wayland (default for Ubuntu 24.04)
@@ -101,7 +120,7 @@ sudo HOME=$HOME XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR PYNPUT_BACKEND_KEYBOARD=uinput
 ```
 You're on the right path :)
 
-### System tray icon (experimental) <img src="scribe_data/share/icon.png" width=48px>
+## System tray icon (experimental) <img src="scribe_data/share/icon.png" width=48px>
 
 To avoid switching back and forth with the terminal, it's possible to interact with the program via an icon tray.
 To activate start with:
@@ -116,15 +135,30 @@ sudo apt install libcairo-dev libgirepository1.0-dev gir1.2-appindicator3-0.1
 pip install PyGObject
 ```
 
-### Start as an application in GNOME
+## Start as an application in GNOME
 
 If you run Ubuntu (or else?) with GNOME, the script `scribe-install [...]` will create a `scribe.desktop` file and place it under `$HOME/.local/share/applications`
-to make it available from the quick launch menu. Any option will be passed on to `scribe`.
+to make it available from the quick launch menu. Any option will be passed on to `scribe`, with the additional options `--name` and `--no-terminal`.
+`--no-terminal` means no terminal will show up, and it also implies the options `--app --no-prompt`.
 
 e.g.
 
 ```bash
-scribe-install --backend whisper --model small
+scribe-install
+scribe-install --name "Scribe Whisper" --backend whisper --model small --clipboard --restart-after-silence --no-prompt
+scribe-install --name "Scribe Vosk FR" --backend vosk --language fr --keyboard --clipboard --no-terminal
 ```
+This will install three separate apps:
+- `Super + scribe` : will launch the default version with terminal prompt
+- `Super + whisper` : will launch a present version with the `small` model from `whisper` and start recording right away. You can see what is going on in the terminal and the result is ready to paste from the clipboard
+- `Super + vosk fr` : will launch a preset version for real-time transcription in French with the `vosk` backend, and throughput to the clipboard and the keyboard, not even opening a terminal.
 
-After that just typing Cmd + scri... at any time from any where will conveniently start the app in its own terminal with the prescribed options.
+
+## Fine tuning
+
+There are a number of options to control the silence threshold, duration and more.
+Best is to check the available options in the online help:
+
+```bash
+scribe --help
+```

{scribe_cli-0.7.11 → scribe_cli-0.9.0}/scribe/_version.py

@@ -12,5 +12,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.7.11'
-__version_tuple__ = version_tuple = (0, 7, 11)
+__version__ = version = '0.9.0'
+__version_tuple__ = version_tuple = (0, 9, 0)

{scribe_cli-0.7.11 → scribe_cli-0.9.0}/scribe/app.py

@@ -1,5 +1,6 @@
 from pathlib import Path
 import tomllib
+import re
 import time
 import argparse
 from scribe.audio import Microphone
@@ -177,16 +178,22 @@ def get_parser():
 
     parser.add_argument("--samplerate", default=16000, type=int, help=argparse.SUPPRESS)
     parser.add_argument("--microphone-device", help="The device index of the microphone to use.", type=int)
-    parser.add_argument("--keyboard", action="store_true")
-    parser.add_argument("--no-clipboard", dest="clipboard", action="store_false")
-    parser.add_argument("--latency", default=0.01, type=float, help="keyboard latency")
-    parser.add_argument("--ascii", action="store_true", help="Use unidecode for keyboard typing in ascii")
+
+    group = parser.add_argument_group("transcription output")
+    group.add_argument("-c", "--clipboard", dest="clipboard", action="store_true")
+    # group.add_argument("--no-clipboard", dest="clipboard", action="store_false", help=argparse.SUPPRESS)
+    group.add_argument("-k", "--keyboard", action="store_true")
+    group.add_argument("-o", "--output-file")
+
+    group = parser.add_argument_group("keyboard options")
+    group.add_argument("--latency", default=0.01, type=float, help="keyboard latency (default %(default)s s)")
+    group.add_argument("--ascii", action="store_true", help="Use unidecode for keyboard typing in ascii")
 
     group = parser.add_argument_group("whisper options")
-    group.add_argument("--duration", default=120, type=float, help="Max duration of the whisper recording (default %(default)ss)")
-    group.add_argument("--silence", default=2, type=float, help="silence duration (default %(default)ss)")
-    group.add_argument("--silence-db", default=-30, type=float, help="silence magnitude in db (default %(default)ss)")
-    group.add_argument("--restart-after-silence", action="store_true", help="Restart the recording after a transcription triggered by a silence")
+    group.add_argument("--duration", default=120, type=float, help="Max duration of the whisper recording (default %(default)s s)")
+    group.add_argument("--silence", default=2, type=float, help="silence duration (default %(default)s s)")
+    group.add_argument("--silence-db", default=-30, type=float, help="silence magnitude in decibel (default %(default)s db)")
+    group.add_argument("-a", "--restart-after-silence", action="store_true", help="Restart the recording after a transcription triggered by a silence")
 
     parser.add_argument("--download-folder-vosk", help="Folder to store Vosk models.")
     parser.add_argument("--download-folder-whisper", help="Folder to store Whisper models.")
@@ -195,18 +202,16 @@ def get_parser():
 
 
 # Commencer l'enregistrement
-def start_recording(micro, transcriber, clipboard=True, keyboard=False, latency=0, ascii=False, callback=None, **greetings):
+def start_recording(micro, transcriber, clipboard=True, keyboard=False, latency=0, ascii=False, output_file=None, callback=None, **greetings):
 
     if keyboard:
         from scribe.keyboard import type_text
         print("\nChange focus to target app during transcription.")
 
-
     if clipboard:
         import pyperclip
         print("\nThe full transcription will be copied to clipboard as it becomes available.")
 
-
     fulltext = ""
 
     for result in transcriber.start_recording(micro, **greetings):
@@ -217,6 +222,10 @@ def start_recording(micro, transcriber, clipboard=True, keyboard=False, latency=
             if keyboard:
                 type_text(result['text'] + " ", interval=latency, ascii=ascii) # Simulate typing
 
+            if output_file:
+                with open(output_file, "a") as f:
+                    f.write(result['text'] + "\n")
+
             if clipboard:
                 fulltext += result['text'] + " "
                 pyperclip.copy(fulltext.strip())
@@ -224,9 +233,6 @@ def start_recording(micro, transcriber, clipboard=True, keyboard=False, latency=
         else:
             print_partial(result.get('partial', ''))
 
-    if clipboard:
-        print("Copied to clipboard.")
-
     if callback:
         callback()
 
@@ -295,7 +301,7 @@ def create_app(micro, transcriber, **kwargs):
     def callback_stop_recording(icon, item):
         # Here we need to stop the recording thread
 
-        transcriber.recording = False
+        transcriber.interrupt = True
         if hasattr(icon, "_recording_thread"):
             icon._recording_thread.join()
         if hasattr(icon, "_monitoring_thread"):
@@ -355,17 +361,26 @@ def main(args=None):
         if transcriber is None:
             transcriber = get_transcriber(o, prompt=o.prompt)
         print(f"Model [{colored(transcriber.model_name, 'light_blue', attrs=['bold'])}] from [{colored(transcriber.backend, 'light_blue', attrs=['bold'])}] selected.")
-        show_options = ["clipboard", "keyboard", "ascii", "app"]
-        activated_options = [colored(option, 'light_blue') for option in show_options if getattr(o, option)]
-        print(f"Options: {' | '.join(activated_options)}")
+        show_output = ["clipboard", "keyboard", "output_file"]
+        show_options = ["ascii", "restart_after_silence"]
+        activated_output = [colored(option if type(getattr(o, option)) is bool else f'{option}={getattr(o, option)}', 'light_blue') for option in show_output if getattr(o, option)]
+        activated_options = [colored(option if type(getattr(o, option)) is bool else f'{option}={getattr(o, option)}', 'light_blue') for option in show_options if getattr(o, option)]
+        if activated_output:
+            print(f"Output: {' | '.join(activated_output)}")
+        else:
+            print(colored(f"No output selected -> terminal only", "light_red"))
+        if o.app:
+            print(colored("App mode enabled", "light_green"))
+        if activated_options:
+            print(f"Options: {' | '.join(activated_options)}")
         if o.prompt:
             print(f"Choose any of the following actions")
-            print(f"{colored('[q]', 'light_yellow')} quit")
             print(f"{colored('[e]', 'light_yellow')} change model")
+            print(f"{colored('[f]', 'light_yellow')} output file is {colored(repr(o.output_file), 'light_blue')}")
+            print(f"{colored('[c]', 'light_yellow')} clipboard is {colored(o.clipboard, 'light_blue')} toggle?")
+            print(f"{colored('[k]', 'light_yellow')} keyboard is {colored(o.keyboard, 'light_blue')} toggle?")
+            print(f"{colored('[x]', 'light_yellow')} app is {colored(o.app, 'light_blue')} toggle?")
             if details:
-                print(f"{colored('[x]', 'light_yellow')} app is {colored(o.app, 'light_blue')} toggle?")
-                print(f"{colored('[c]', 'light_yellow')} clipboard is {colored(o.clipboard, 'light_blue')} toggle?")
-                print(f"{colored('[k]', 'light_yellow')} keyboard is {colored(o.keyboard, 'light_blue')} toggle?")
                 if o.keyboard:
                     print(f"{colored('[latency]', 'light_yellow')} between keystrokes is {colored(o.latency, 'light_blue')} s")
                 if transcriber.backend == "whisper":
@@ -379,21 +394,22 @@ def main(args=None):
                     if key not in display_flags or key in exclude_flags or not isinstance(value, bool):
                         continue
                     print(f"{colored(f'[{key}]', 'light_yellow')} is {colored(value, 'light_blue')} toggle?")
-                print(f"{colored('[o]', 'light_yellow')} hide options")
+                print(f"{colored('[-]', 'light_yellow')} hide options")
             else:
-                print(f"{colored('[o]', 'light_yellow')} show options")
-
+                print(f"{colored('[-]', 'light_yellow')} show more options")
+            print(f"{colored('[q]', 'light_yellow')} quit")
             print(colored(f"Press [Enter] to start recording.", attrs=["bold"]))
 
             key = input()
             if key == "q":
                 exit(0)
-            if key == "o":
+            if len(key) > 0 and key.strip() in ["", ".", "-", "+", 'o', '\x1b[A', '\x1b[B', '\x1b[C', '\x1b[D']:  # arrow keys
                 details = not details
                 continue
             if key == "e":
                 transcriber = None
                 o.model = None
+                o.dummy = False
                 o.backend = None
                 o.language = None
                 continue
@@ -407,7 +423,7 @@ def main(args=None):
                 o.app = not o.app
                 continue
             if key == "a":
-                transcriber.restart_after_silence = not transcriber.restart_after_silence
+                o.restart_after_silence = transcriber.restart_after_silence = not transcriber.restart_after_silence
                 continue
             if key == "t":
                 ans = input(f"Enter new duration in seconds (current: {transcriber.timeout}): ")
@@ -437,18 +453,27 @@ def main(args=None):
                 except:
                     print("Invalid duration. Must be a float.")
                 continue
+            if key == "f":
+                ans = input(f"Enter output file (current: {o.output_file}): ")
+                invalid_regex = re.compile(r'[^A-Za-z0-9_\-\\\/\.]')
+                if not invalid_regex.search(ans):
+                    o.output_file = ans
+                else:
+                    print(f"Invalid characters: {' '.join(map(repr, invalid_regex.findall(ans)))}")
+                    print(f"Invalid file name: {repr(ans)}")
+                continue
             if key:
                 if hasattr(o, key) and isinstance(getattr(o, key), bool):
                     setattr(o, key, not getattr(o, key))
                     print(f"Toggle {key} to [{getattr(o, key)}].")
-                print(f"Invalid choice: {key}.")
+                print(f"Invalid choice: {repr(key)}")
                 continue
 
         if o.app:
             greetings = dict(
                 start_message = "Listening... Use the try icon menu to stop.",
             )
-            app = create_app(micro, transcriber, clipboard=o.clipboard,
+            app = create_app(micro, transcriber, clipboard=o.clipboard, output_file=o.output_file,
                              keyboard=o.keyboard, latency=o.latency, ascii=o.ascii, **greetings)
             print("Starting app...")
             app.run()
@@ -456,7 +481,7 @@ def main(args=None):
             greetings = dict(
                 start_message = "Listening... Press Ctrl+C to stop.",
             )
-            start_recording(micro, transcriber, clipboard=o.clipboard,
+            start_recording(micro, transcriber, clipboard=o.clipboard, output_file=o.output_file,
                             keyboard=o.keyboard, latency=o.latency, ascii=o.ascii, **greetings)
 
         # if we arrived so far, that means we pressed Ctrl + C anyway, and need Enter to move on.

{scribe_cli-0.7.11 → scribe_cli-0.9.0}/scribe/install_desktop.py

@@ -10,9 +10,17 @@ def main():
         sys.exit(0)
 
     parser = argparse.ArgumentParser("Install the desktop file for the scribe package. Any arguments to this script will be passed on to `scribe`.")
+    parser.add_argument("--name", help="The title of the desktop app", default="Scribe")
+    parser.add_argument("--startup-wm-class")
+    parser.add_argument("--no-terminal", action="store_false", dest="terminal", help="Don't show the terminal (goes in --app mode)")
     o, rest = parser.parse_known_args()
     o.arguments = rest
 
+    if not o.terminal and "--app" not in o.arguments:
+        o.arguments.append("--app")
+    if not o.terminal and "--no-prompt" not in o.arguments:
+        o.arguments.append("--no-prompt")
+
     SOURCE_SCRIBE_DATA = os.path.dirname(scribe_data.__file__)
 
     HOME = os.environ.get('HOME',os.path.expanduser('~'))
@@ -25,15 +33,18 @@ def main():
     with open(os.path.join(SOURCE_SCRIBE_DATA, 'templates', 'scribe.desktop')) as f:
         template = f.read()
 
+    simple_name = o.name.lower().replace(' ','-').replace(os.path.sep, '-')
     bin_folder = sysconfig.get_path("scripts")
     icon_folder = os.path.join(SOURCE_SCRIBE_DATA, 'share')
-    desktop_filecontent = template.format(icon_folder=icon_folder, bin_folder=bin_folder, options=' '.join(o.arguments) if o.arguments else '')
+    desktop_filecontent = template.format(icon_folder=icon_folder, bin_folder=bin_folder,
+                                          name=o.name, terminal=str(o.terminal).lower(),
+                                          StartupWMClass=o.startup_wm_class or f"crx_mpnasdanpmm_{simple_name}",
+                                          options=' ' + ' '.join(o.arguments) if o.arguments else '')
 
-    desktop_filepath = os.path.join(XDG_APP_DATA, 'scribe.desktop')
+    desktop_filepath = os.path.join(XDG_APP_DATA, f'{simple_name}.desktop')
     print("Writing GNOME desktop file:", desktop_filepath)
     with open(desktop_filepath, "w") as f:
         f.write(desktop_filecontent)
 
-
 if __name__ == "__main__":
     main()

{scribe_cli-0.7.11 → scribe_cli-0.9.0}/scribe/models.py

@@ -35,6 +35,7 @@ class AbstractTranscriber:
         self.recording = False
         self.busy = False
         self.waiting = False
+        self.interrupt = False
         self.reset()
 
     def get_elapsed(self):
@@ -59,6 +60,7 @@ class AbstractTranscriber:
                         stop_message="Done transcribing."):
 
         self.reset()
+        self.interrupt = False
         self.recording = True
         self.waiting = True
         self.busy = True
@@ -73,7 +75,7 @@ class AbstractTranscriber:
             with microphone.open_stream():
                 print(start_message)
 
-                while self.recording:
+                while not self.interrupt:
                     while not microphone.q.empty():
                         data = microphone.q.get()
 

{scribe_cli-0.7.11 → scribe_cli-0.9.0/scribe_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: scribe-cli
-Version: 0.7.11
+Version: 0.9.0
 Summary: scribe is a local speech recognition tool that provides real-time transcription using vosk and whisper AI, with the goal of serving as a virtual keyboard on a computer
 Author-email: Mahé Perrette <mahe.perrette@gmail.com>
 License: MIT License
@@ -118,7 +118,7 @@ scribe
 and the script will guide you through the choice of backend (`whisper` or `vosk`) and the specific language model.
 After this, you will be prompted to start recording your microphone and print the transcribed text in real-time (`vosk`)
 or until after recording is complete (`whisper`).
-You can interrupt the recording via Ctrl + C and start again or change model. The full content of the transcription will be pasted to the clipboard by default, until interruption.
+You can interrupt the recording via Ctrl + C and start again or change model.
 
 The default (`whisper`) is excellent at transcribing a full-length audio sequences in [many languages](https://github.com/openai/whisper?tab=readme-ov-file#available-models-and-languages). It is really impressive,
 but it cannot do real-time, and depending on the model can have relatively long execution time, especially with the `turbo` model (at least on my laptop with CPU only). The `small` model is also excellent and runs much faster. It is selected as default in `scribe` for that reason.
@@ -135,19 +135,38 @@ scribe --backend whisper --model small --no-prompt
 ```
 where `--no-prompt` jumps right to the recording (after the first interruption, you can still choose to change the backend and model).
 
-### Virtual keyboard (experimental)
+## Output media
+
+By default the transcription is printed on the terminal, but other output media are supported.
+
+### Clipboard
+
+The most straightforward is the clipboard:
+
+```bash
+scribe --clipboard
+```
+The content of the (full) transcription is then pasted to the clipboard, and it is up to the user to paste (e.g. Ctrl + V).
 
-By default the content of the transcription is pasted to the clipboard, and it is up to the user to paste (e.g. Ctrl + V).
-However with the `vosk` backend and its realtime transcription, it is very handy to have the keys sent directly to the keyboard.
-That can be achieve with the `--keyboard` option.
+### Output file
 
-With the `--keyboard` option `scribe` will attempt to simulate a keyboard and send transcribed characters to the applcation under focus:
+Alternatively an output file can be indicated:
+
+```bash
+ --keyboard -o transcription.txt
+```
+
+### Virtual keyboard (experimental)
+
+With the `--keyboard` option `scribe` will attempt to simulate a keyboard and send transcribed characters to the application under focus:
 
 ```bash
 scribe --keyboard
 ```
 
-It relies on the optional `pynput` dependency (installed together with `scribe` if you used the `[all]` or `[keyboard]` option).
+This can be extremely useful with the `vosk` backend and its realtime transcription, or alternatively with the `--restart` option with the `whisper` backend.
+
+The `--keyboard` option relies on the optional `pynput` dependency (installed together with `scribe` if you used the `[all]` or `[keyboard]` option).
 Depending on your operating system, `pynput` may require additional configuration to work around its [limitations](https://pynput.readthedocs.io/en/latest/limitations.html).
 
 #### Use the keyboard with Wayland (default for Ubuntu 24.04)
@@ -164,7 +183,7 @@ sudo HOME=$HOME XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR PYNPUT_BACKEND_KEYBOARD=uinput
 ```
 You're on the right path :)
 
-### System tray icon (experimental) <img src="scribe_data/share/icon.png" width=48px>
+## System tray icon (experimental) <img src="scribe_data/share/icon.png" width=48px>
 
 To avoid switching back and forth with the terminal, it's possible to interact with the program via an icon tray.
 To activate start with:
@@ -179,15 +198,30 @@ sudo apt install libcairo-dev libgirepository1.0-dev gir1.2-appindicator3-0.1
 pip install PyGObject
 ```
 
-### Start as an application in GNOME
+## Start as an application in GNOME
 
 If you run Ubuntu (or else?) with GNOME, the script `scribe-install [...]` will create a `scribe.desktop` file and place it under `$HOME/.local/share/applications`
-to make it available from the quick launch menu. Any option will be passed on to `scribe`.
+to make it available from the quick launch menu. Any option will be passed on to `scribe`, with the additional options `--name` and `--no-terminal`.
+`--no-terminal` means no terminal will show up, and it also implies the options `--app --no-prompt`.
 
 e.g.
 
 ```bash
-scribe-install --backend whisper --model small
+scribe-install
+scribe-install --name "Scribe Whisper" --backend whisper --model small --clipboard --restart-after-silence --no-prompt
+scribe-install --name "Scribe Vosk FR" --backend vosk --language fr --keyboard --clipboard --no-terminal
 ```
+This will install three separate apps:
+- `Super + scribe` : will launch the default version with terminal prompt
+- `Super + whisper` : will launch a present version with the `small` model from `whisper` and start recording right away. You can see what is going on in the terminal and the result is ready to paste from the clipboard
+- `Super + vosk fr` : will launch a preset version for real-time transcription in French with the `vosk` backend, and throughput to the clipboard and the keyboard, not even opening a terminal.
+
 
-After that just typing Cmd + scri... at any time from any where will conveniently start the app in its own terminal with the prescribed options.
+## Fine tuning
+
+There are a number of options to control the silence threshold, duration and more.
+Best is to check the available options in the online help:
+
+```bash
+scribe --help
+```

scribe_cli-0.9.0/scribe_data/templates/scribe.desktop

@@ -0,0 +1,8 @@
+#!/usr/bin/env xdg-open
+[Desktop Entry]
+Terminal={terminal}
+Type=Application
+Name={name}
+Exec={bin_folder}/scribe{options}
+Icon={icon_folder}/icon.png
+StartupWMClass={StartupWMClass}

scribe_cli-0.7.11/scribe_data/templates/scribe.desktop

@@ -1,8 +0,0 @@
-#!/usr/bin/env xdg-open
-[Desktop Entry]
-Terminal=true
-Type=Application
-Name=Scribe
-Exec={bin_folder}/scribe{options}
-Icon={icon_folder}/icon.jpg
-StartupWMClass=crx_mpnasdanpmmopoasdjdcgaaiekailkhb