mirror of
https://github.com/chidiwilliams/buzz.git
synced 2026-03-14 22:55:46 +01:00
16 lines
No EOL
20 KiB
HTML
16 lines
No EOL
20 KiB
HTML
<!doctype html>
|
||
<html lang="en-US" dir="ltr" class="docs-wrapper docs-doc-page docs-version-current plugin-docs plugin-id-default docs-doc-id-faq">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta name="generator" content="Docusaurus v2.4.1">
|
||
<title data-rh="true">FAQ | Buzz</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://chidiwilliams.github.io/buzz/img/favicon.ico"><meta data-rh="true" name="twitter:image" content="https://chidiwilliams.github.io/buzz/img/favicon.ico"><meta data-rh="true" property="og:url" content="https://chidiwilliams.github.io/buzz/docs/faq"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="FAQ | Buzz"><meta data-rh="true" name="description" content="1. Where are the models stored?"><meta data-rh="true" property="og:description" content="1. Where are the models stored?"><link data-rh="true" rel="icon" href="/buzz/img/favicon.ico"><link data-rh="true" rel="canonical" href="https://chidiwilliams.github.io/buzz/docs/faq"><link data-rh="true" rel="alternate" href="https://chidiwilliams.github.io/buzz/docs/faq" hreflang="en-US"><link data-rh="true" rel="alternate" href="https://chidiwilliams.github.io/buzz/zh/docs/faq" hreflang="zh-CN"><link data-rh="true" rel="alternate" href="https://chidiwilliams.github.io/buzz/docs/faq" hreflang="x-default"><link rel="stylesheet" href="/buzz/assets/css/styles.5917496c.css">
|
||
<link rel="preload" href="/buzz/assets/js/runtime~main.08691750.js" as="script">
|
||
<link rel="preload" href="/buzz/assets/js/main.a68079c4.js" as="script">
|
||
</head>
|
||
<body class="navigation-with-keyboard">
|
||
<script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}var e=function(){var t=null;try{t=new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}return t}()||function(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}();t(null!==e?e:"light")}()</script><div id="__docusaurus">
|
||
<div role="region" aria-label="Skip to main content"><a class="skipToContent_fXgn" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><nav aria-label="Main" class="navbar navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/buzz/"><div class="navbar__logo"><img src="/buzz/img/favicon.ico" alt="Buzz" class="themedImage_ToTc themedImage--light_HNdA"><img src="/buzz/img/favicon.ico" alt="Buzz" class="themedImage_ToTc themedImage--dark_i4oU"></div><b class="navbar__title text--truncate">Buzz</b></a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/buzz/docs">Docs</a><div class="navbar__item dropdown dropdown--hoverable"><a href="#" aria-haspopup="true" aria-expanded="false" role="button" class="navbar__link"><svg viewBox="0 0 24 24" width="20" height="20" aria-hidden="true" class="iconLanguage_nlXk"><path fill="currentColor" d="M12.87 15.07l-2.54-2.51.03-.03c1.74-1.94 2.98-4.17 3.71-6.53H17V4h-7V2H8v2H1v1.99h11.17C11.5 7.92 10.44 9.75 9 11.35 8.07 10.32 7.3 9.19 6.69 8h-2c.73 1.63 1.73 3.17 2.98 4.56l-5.09 5.02L4 19l5-5 3.11 3.11.76-2.04zM18.5 10h-2L12 22h2l1.12-3h4.75L21 22h2l-4.5-12zm-2.62 7l1.62-4.33L19.12 17h-3.24z"></path></svg>English</a><ul class="dropdown__menu"><li><a href="/buzz/docs/faq" target="_self" rel="noopener noreferrer" class="dropdown__link dropdown__link--active" lang="en-US">English</a></li><li><a href="/buzz/zh/docs/faq" target="_self" rel="noopener noreferrer" class="dropdown__link" lang="zh-CN">简体中文</a></li></ul></div></div><div class="navbar__items navbar__items--right"><a href="https://github.com/chidiwilliams/buzz" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link">GitHub<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a><div class="toggle_vylO colorModeToggle_DEke"><button class="clean-btn toggleButton_gllP toggleButtonDisabled_aARS" type="button" disabled="" title="Switch between dark and light mode (currently light mode)" aria-label="Switch between dark and light mode (currently light mode)" aria-live="polite"><svg viewBox="0 0 24 24" width="24" height="24" class="lightToggleIcon_pyhR"><path fill="currentColor" d="M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" class="darkToggleIcon_wfgR"><path fill="currentColor" d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"></path></svg></button></div><div class="searchBox_ZlJk"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="__docusaurus_skipToContent_fallback" class="main-wrapper mainWrapper_z2l0 docsWrapper_BCFX"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_sjWU" type="button"></button><div class="docPage__5DB"><aside class="theme-doc-sidebar-container docSidebarContainer_b6E3"><div class="sidebarViewport_Xe31"><div class="sidebar_njMd"><nav aria-label="Docs sidebar" class="menu thin-scrollbar menu_SIkG"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/buzz/docs">Introduction</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/buzz/docs/installation">Installation</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" aria-expanded="false" href="/buzz/docs/usage/file_import">Usage</a></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/buzz/docs/preferences">Preferences</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/buzz/docs/cli">CLI</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link menu__link--active" aria-current="page" href="/buzz/docs/faq">FAQ</a></li></ul></nav></div></div></aside><main class="docMainContainer_gTbr"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_VOVn"><div class="docItemContainer_Djhp"><article><nav class="theme-doc-breadcrumbs breadcrumbsContainer_Z_bl" aria-label="Breadcrumbs"><ul class="breadcrumbs" itemscope="" itemtype="https://schema.org/BreadcrumbList"><li class="breadcrumbs__item"><a aria-label="Home page" class="breadcrumbs__link" href="/buzz/"><svg viewBox="0 0 24 24" class="breadcrumbHomeIcon_YNFT"><path d="M10 19v-5h4v5c0 .55.45 1 1 1h3c.55 0 1-.45 1-1v-7h1.7c.46 0 .68-.57.33-.87L12.67 3.6c-.38-.34-.96-.34-1.34 0l-8.36 7.53c-.34.3-.13.87.33.87H5v7c0 .55.45 1 1 1h3c.55 0 1-.45 1-1z" fill="currentColor"></path></svg></a></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link" itemprop="name">FAQ</span><meta itemprop="position" content="1"></li></ul></nav><div class="tocCollapsible_ETCw theme-doc-toc-mobile tocMobile_ITEo"><button type="button" class="clean-btn tocCollapsibleButton_TO0P">On this page</button></div><div class="theme-doc-markdown markdown"><header><h1>FAQ</h1></header><h3 class="anchor anchorWithStickyNavbar_LWe7" id="1-where-are-the-models-stored">1. Where are the models stored?<a href="#1-where-are-the-models-stored" class="hash-link" aria-label="Direct link to 1. Where are the models stored?" title="Direct link to 1. Where are the models stored?"></a></h3><p>The models are stored:</p><ul><li>Linux: <code>~/.cache/Buzz</code></li><li>Mac OS: <code>~/Library/Caches/Buzz</code></li><li>Windows: <code>%USERPROFILE%\AppData\Local\Buzz\Buzz\Cache</code></li></ul><p>Paste the location in your file manager to access the models.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="2-what-can-i-try-if-the-transcription-runs-too-slowly">2. What can I try if the transcription runs too slowly?<a href="#2-what-can-i-try-if-the-transcription-runs-too-slowly" class="hash-link" aria-label="Direct link to 2. What can I try if the transcription runs too slowly?" title="Direct link to 2. What can I try if the transcription runs too slowly?"></a></h3><p>Speech recognition requires large amount of computation, so one option is to try using a lower Whisper model size or using a Whisper.cpp model to run speech recognition of your computer. If you have access to a computer with GPU that has at least 6GB of VRAM you can try using the Faster Whisper model.</p><p>Buzz also supports using OpenAI API to do speech recognition on a remote server. To use this feature you need to set OpenAI API key in Preferences. See <a href="https://chidiwilliams.github.io/buzz/docs/preferences" target="_blank" rel="noopener noreferrer">Preferences</a> section for more details.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="3-how-to-record-system-audio">3. How to record system audio?<a href="#3-how-to-record-system-audio" class="hash-link" aria-label="Direct link to 3. How to record system audio?" title="Direct link to 3. How to record system audio?"></a></h3><p>To transcribe system audio you need to configure virtual audio device and connect output from the applications you want to transcribe to this virtual speaker. After that you can select it as source in the Buzz. See <a href="https://chidiwilliams.github.io/buzz/docs/usage/live_recording" target="_blank" rel="noopener noreferrer">Usage</a> section for more details.</p><p>Relevant tools:</p><ul><li>Mac OS - <a href="https://github.com/ExistentialAudio/BlackHole" target="_blank" rel="noopener noreferrer">BlackHole</a>.</li><li>Windows - <a href="https://vb-audio.com/Cable/" target="_blank" rel="noopener noreferrer">VB CABLE</a></li><li>Linux - <a href="https://wiki.ubuntu.com/record_system_sound" target="_blank" rel="noopener noreferrer">PulseAudio Volume Control</a></li></ul><h3 class="anchor anchorWithStickyNavbar_LWe7" id="4-what-model-should-i-use">4. What model should I use?<a href="#4-what-model-should-i-use" class="hash-link" aria-label="Direct link to 4. What model should I use?" title="Direct link to 4. What model should I use?"></a></h3><p>Model size to use will depend on your hardware and use case. Smaller models will work faster but will have more inaccuracies. Larger models will be more accurate but will require more powerful hardware or longer time to transcribe.</p><p>When choosing among large models consider the following. "Large" is the first released older model, "Large-V2" is later updated model with better accuracy, for some languages considered the most robust and stable. "Large-V3" is the latest model with the best accuracy in many cases, but some times can hallucinate or invent words that were never in the audio. "Turbo" model tries to get a good balance between speed and accuracy. The only sure way to know what model best suits your needs is to test them all in your language.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="5-how-to-get-gpu-acceleration-for-faster-transcription">5. How to get GPU acceleration for faster transcription?<a href="#5-how-to-get-gpu-acceleration-for-faster-transcription" class="hash-link" aria-label="Direct link to 5. How to get GPU acceleration for faster transcription?" title="Direct link to 5. How to get GPU acceleration for faster transcription?"></a></h3><p>On Linux GPU acceleration is supported out of the box on Nvidia GPUs. If you still get any issues install <a href="https://developer.nvidia.com/cuda-downloads" target="_blank" rel="noopener noreferrer">CUDA 12</a>, <a href="https://developer.nvidia.com/cublas" target="_blank" rel="noopener noreferrer">cuBLASS</a> and <a href="https://developer.nvidia.com/cudnn" target="_blank" rel="noopener noreferrer">cuDNN</a>.</p><p>On Windows see <a href="https://github.com/chidiwilliams/buzz/blob/main/CONTRIBUTING.md#gpu-support" target="_blank" rel="noopener noreferrer">this note</a> on enabling CUDA GPU support.</p><p>For Faster whisper CUDA 12 is required, computers with older CUDA versions will use CPU.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="6-how-to-fix-unanticipated-host-errorpaerrorcode-9999">6. How to fix <code>Unanticipated host error[PaErrorCode-9999]</code>?<a href="#6-how-to-fix-unanticipated-host-errorpaerrorcode-9999" class="hash-link" aria-label="Direct link to 6-how-to-fix-unanticipated-host-errorpaerrorcode-9999" title="Direct link to 6-how-to-fix-unanticipated-host-errorpaerrorcode-9999"></a></h3><p>Check if there are any system settings preventing apps from accessing the microphone.</p><p>On Windows, see if Buzz has permission to use the microphone in Settings -> Privacy -> Microphone.</p><p>See method 1 in this video <a href="https://www.youtube.com/watch?v=eRcCYgOuSYQ" target="_blank" rel="noopener noreferrer">https://www.youtube.com/watch?v=eRcCYgOuSYQ</a></p><p>For method 2 there is no need to uninstall the antivirus, but see if you can temporarily disable it or if there are settings that may prevent Buzz from accessing the microphone.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="7-can-i-use-buzz-on-a-computer-without-internet">7. Can I use Buzz on a computer without internet?<a href="#7-can-i-use-buzz-on-a-computer-without-internet" class="hash-link" aria-label="Direct link to 7. Can I use Buzz on a computer without internet?" title="Direct link to 7. Can I use Buzz on a computer without internet?"></a></h3><p>Yes, Buzz can be used without internet connection if you download the necessary models on some other computer that has the internet and manually move them to the offline computer. The easiest way to find where the models are stored is to go to Help -> Preferences -> Models. Then download some model, and push "Show file location" button. This will open the folder where the models are stored. Copy the models folder to the same location on the offline computer. F.e. for Linux it is <code>.cache/Buzz/models</code> in your home directory.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="8-buzz-crashes-what-to-do">8. Buzz crashes, what to do?<a href="#8-buzz-crashes-what-to-do" class="hash-link" aria-label="Direct link to 8. Buzz crashes, what to do?" title="Direct link to 8. Buzz crashes, what to do?"></a></h3><p>If a model download was incomplete or corrupted, Buzz may crash. Try to delete the downloaded model files in <code>Help -> Preferences -> Models</code> and re-download them.</p><p>If that does not help, check the log file for errors and <a href="https://github.com/chidiwilliams/buzz/issues" target="_blank" rel="noopener noreferrer">report the issue</a> so we can fix it. The log file is located in <code>~/Library/Logs/Buzz</code> (Mac OS) or <code>%USERPROFILE%\AppData\Local\Buzz\Buzz\Logs</code> (Windows). On Linux run the Buzz from the command line to see the relevant messages.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="9-where-can-i-get-latest-development-version">9. Where can I get latest development version?<a href="#9-where-can-i-get-latest-development-version" class="hash-link" aria-label="Direct link to 9. Where can I get latest development version?" title="Direct link to 9. Where can I get latest development version?"></a></h3><p>Latest development version will have latest bug fixes and most recent features. If you feel a bit adventurous it is recommended to try the latest development version as they needs some testing before they get released to everybody.</p><ul><li><p><strong>Linux</strong> users can get the latest version with this command <code>sudo snap install buzz --edge</code></p></li><li><p><strong>For other</strong> platforms do the following:</p><ol><li>Go to the <a href="https://github.com/chidiwilliams/buzz/actions/workflows/ci.yml?query=branch%3Amain" target="_blank" rel="noopener noreferrer">build section</a></li><li>Click on the link to the latest build</li><li>Scroll down to the artifacts section in the build page</li><li>Download the installation file. Please note that you need to be logged in the Github to see the download links.</li></ol></li></ul></div></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/buzz/docs/cli"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">CLI</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#1-where-are-the-models-stored" class="table-of-contents__link toc-highlight">1. Where are the models stored?</a></li><li><a href="#2-what-can-i-try-if-the-transcription-runs-too-slowly" class="table-of-contents__link toc-highlight">2. What can I try if the transcription runs too slowly?</a></li><li><a href="#3-how-to-record-system-audio" class="table-of-contents__link toc-highlight">3. How to record system audio?</a></li><li><a href="#4-what-model-should-i-use" class="table-of-contents__link toc-highlight">4. What model should I use?</a></li><li><a href="#5-how-to-get-gpu-acceleration-for-faster-transcription" class="table-of-contents__link toc-highlight">5. How to get GPU acceleration for faster transcription?</a></li><li><a href="#6-how-to-fix-unanticipated-host-errorpaerrorcode-9999" class="table-of-contents__link toc-highlight">6. How to fix <code>Unanticipated host error[PaErrorCode-9999]</code>?</a></li><li><a href="#7-can-i-use-buzz-on-a-computer-without-internet" class="table-of-contents__link toc-highlight">7. Can I use Buzz on a computer without internet?</a></li><li><a href="#8-buzz-crashes-what-to-do" class="table-of-contents__link toc-highlight">8. Buzz crashes, what to do?</a></li><li><a href="#9-where-can-i-get-latest-development-version" class="table-of-contents__link toc-highlight">9. Where can I get latest development version?</a></li></ul></div></div></div></div></main></div></div></div>
|
||
<script src="/buzz/assets/js/runtime~main.08691750.js"></script>
|
||
<script src="/buzz/assets/js/main.a68079c4.js"></script>
|
||
</body>
|
||
</html> |