{"id":49058281,"url":"https://github.com/mikiher/audiobookshelf-windows","last_synced_at":"2026-05-18T00:14:20.784Z","repository":{"id":214984207,"uuid":"736019169","full_name":"mikiher/audiobookshelf-windows","owner":"mikiher","description":"Installs and manages Audiobookshelf on Windows","archived":false,"fork":false,"pushed_at":"2026-04-27T22:25:41.000Z","size":92,"stargazers_count":146,"open_issues_count":16,"forks_count":6,"subscribers_count":6,"default_branch":"master","last_synced_at":"2026-04-28T00:26:13.065Z","etag":null,"topics":["audiobookshelf","windows"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mikiher.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-12-26T18:46:08.000Z","updated_at":"2026-04-24T14:58:41.000Z","dependencies_parsed_at":"2024-01-07T16:58:27.892Z","dependency_job_id":"b730fd9c-98e6-4101-92ba-b86058223e42","html_url":"https://github.com/mikiher/audiobookshelf-windows","commit_stats":null,"previous_names":["mikiher/audiobookshelf-windows"],"tags_count":62,"template":false,"template_full_name":null,"purl":"pkg:github/mikiher/audiobookshelf-windows","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikiher%2Faudiobookshelf-windows","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikiher%2Faudiobookshelf-windows/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikiher%2Faudiobookshelf-windows/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikiher%2Faudiobookshelf-windows/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mikiher","download_url":"https://codeload.github.com/mikiher/audiobookshelf-windows/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikiher%2Faudiobookshelf-windows/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33160182,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-17T22:39:12.733Z","status":"ssl_error","status_checked_at":"2026-05-17T22:39:10.741Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audiobookshelf","windows"],"created_at":"2026-04-20T00:14:48.392Z","updated_at":"2026-05-18T00:14:20.755Z","avatar_url":"https://github.com/mikiher.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# audiobookshelf-windows\nInstalls and manages the [audiobookshelf](https://github.com/advplyr/audiobookshelf) server on Windows.\n\nIt installs the latest released version of the server itself (pre-packaged as a Windows executable), and a tray app for managing it. \nThe tray app runs in the background, and can be accessed by clicking the Audiobookshelf tray icon \n(\u003cimg src=\"Resources/AppIcon.ico\" width=\"16\" height=\"16\"/\u003e) in the system tray (bottom right corner of the screen).\n\nThe tray app lets you:\n- Open the server in your default browser\n- Start/Stop the server\n- Set the server to start on login\n- View the server logs\n- Change the server port and data folder\n- Check for updates, download and install them\n\nAudiobookshelf-windows releases are automatically kept up to date with the latest audiobookshelf server releases.\n\n## System Requirements\n- Windows 10 64-bit or later\n\nYou **do not** need to install .NET Framework, as it is included in any Windows 10/11 installation.\n\nYou **do not** need to install Node.js, as the server executable is pre-packaged with it.\n\n## Installation\nDownload the latest installer release from the [release page](https://github.com/mikiher/audiobookshelf-windows/releases/latest) and run it.\n\n## Caveats\n- It's not currently possible to migrate the server data from a previous Windows Docker installation to this one (see [this issue](https://github.com/mikiher/audiobookshelf-windows/issues/3))\n\n## Development\nAll development was done on a Windows 10 64-bit desktop.\n\nThe tray app was developed in C# using .NET Framework 4.6.1 and Winforms.\nIt was based on the [audiobookshelf-win](https://github.com/advplyr/audiobookshelf-win) codebase by [advplyr](https://github.com/advplyr).\n\nThe installer was developed using [Inno Setup](https://jrsoftware.org/isinfo.php).\n\n### 1. Building the Audiobookshelf server executable\n- Install [Node.js 20](https://nodejs.org/en/download/) (Must be version 20) \n    - Optional: install [nvm-windows](https://github.com/coreybutler/nvm-windows#installation--upgrades) to manage multiple Node.js versions\n- Install Visual Studio Code\n- Clone the [audiobookshelf](https://github.com/advplyr/audiobookshelf.git) Github repository\n- Open the `audiobookshelf` folder in Visual Studio Code\n- Open the terminal (Ctrl+Shift+`)\n- Run `npm ci` to install the dependencies\n- Run `npm i @yao-pkg/pkg -g` to install the yao-pkg (Node.js to executable) package. Yao-pkg is a fork of the original pkg package, which is no longer maintained.\n- Run `npm run build-win` to build the audiobookshelf server executable (it will be placed in the `dist\\win` folder)\n\n### 2. Building the Audiobookshelf tray app\nThe tray app can be built using either Visual Studio 2022 or Visual Studio Code.\n- If you need to make design changes to the UI, it's recommended to use Visual Studio 2022, as it has a visual designer for Winforms.\n- It's convenient to use Visual Studio 2022 since it has a built-in debug console, in which you can see Debeug.WriteLine() messages.\n- If you only need to make code changes, you can use Visual Studio Code.\n\n#### On Visual Studio 2022\n- Install [Visual Studio 2022 Community Edition](https://visualstudio.microsoft.com/downloads/)\n- Install the [.NET Desktop Development workload](https://learn.microsoft.com/en-us/visualstudio/install/install-visual-studio?view=vs-2022#step-4---choose-workloads)\n- Clone [this repository](https://github.com/mikiher/audiobookshelf-windows.git)\n- Open the `Audiobookshelf.sln` solution file in Visual Studio\n- Build the solution (F6) (you will find the executable in the `bin\\x64\\Release\\net461` or `bin\\x64\\Debug\\net461` folder, depending on the build configuration)\n\n#### On Visual Studio Code\n- Install [Visual Studio Code](https://code.visualstudio.com/download)\n- Install the [C# Dev Kit](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit)\n- Install the latest [.NET SDK](https://dotnet.microsoft.com/en-us/download)\n- Clone [this repository](https://github.com/mikiher/audiobookshelf-windows.git)\n- Open the terminal (Ctrl+Shift+`)\n- Run `dotnet build -c Release` or `dotnet build` to build the solution (you will find the executable in the `bin\\x64\\Release\\net461` or `bin\\x64\\Debug\\net461` folder, depending on the build configuration)\n\n#### Running the tray app\nYou can run or debug the tray app directly from Visual Studio 2022 or Visual Studio Code.\n- Copy the audiobookshelf server executable to the `bin\\x64\\Release\\net461` or `bin\\x64\\Debug\\net461` folder, depending on the build configuration\n- The app tries to read the `AppVersion` and `DataDir` values from the registry key `HKEY_CURRENT_USER\\SOFTWARE\\Audiobookshelf`, and if they are not found, it will use the default values\n- Run or debug the app (F5). By default, the app will: \n    - try to get the server data folder from the registry key `HKEY_CURRENT_USER\\SOFTWARE\\Audiobookshelf\\DataDir`\n        - if not found, the default value `%LocalAppData%\\Audiobookshelf` will be used\n    - try to get the app version from the registry key `HKEY_CURRENT_USER\\SOFTWARE\\Audiobookshelf\\AppVersion`\n    - run the server on port 13378 by default\n\n### 3. Building the installer\n- Install [Visual Studio Code](https://code.visualstudio.com/download)\n- Install [Inno Setup](https://jrsoftware.org/isinfo.php)\n- Install the [Inno Setup extension](https://marketplace.visualstudio.com/items?itemName=Chouzz.vscode-innosetup) for Visual Studio Code\n- Clone [this repository](https://github.com/mikiher/audiobookshelf-windows.git)\n- Open `Setup\\installer.iss` in Visual Studio Code\n- Change `#define MyAppBinDir` to the folder where the Audiobookshelf tray app executable and dlls are located\n- Change `#define ServerBinDir` to the folder where the Audiobookshelf server executable is located\n- Run the `Build Installer` task (Ctrl+Shift+B) to build the installer (you will find it in the `Setup\\Output` folder)\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmikiher%2Faudiobookshelf-windows","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmikiher%2Faudiobookshelf-windows","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmikiher%2Faudiobookshelf-windows/lists"}