# OperaLibre installation and Audible sign-in ## 00:00:00 — Let’s install OperaLibre. A first-time setup, from the installer to your phone. Use a Mac or Linux computer that stays on. Keep Terminal open until setup finishes. This walkthrough follows a fresh macOS or Linux installation. It prepares the optional Audible import, sets up optional Tailscale, creates your account, connects Audible in OperaLibre, then connects the app. ## 00:00:10 — Start the guided installer. Open Terminal. Copy the command from operalibre.com. Paste the whole command, then press Return. Setup pauses for your answers. That is expected. Copy the install command from the website, paste it into Terminal, and press Return. Run it as your regular user. ## 00:00:24 — How to answer a prompt. Return accepts the default. Type an answer to change it. Y/n means yes is the default. y/N means no is the default. A folder in brackets is its default. Press Return to accept the value in brackets. Y/n defaults to yes. y/N defaults to no. Type y or n to choose explicitly. ## 00:00:36 — Choose the install folder. The default keeps OperaLibre in your home folder. Prompt: `Install folder [/Users/you/OperaLibre]:` Example answer: `Return` For a new install, the default is a good starting point. Linux uses /home/you instead. Your username replaces you. At Install folder, press Return to accept the suggested folder, or type another path. The displayed username and home path vary by computer. ## 00:00:50 — Choose the audiobook folder. Use the default, or enter the folder that holds your books. Prompt: `Audiobook folder [/Users/you/OperaLibre/audiobooks]:` Example answer: `Return` Return uses a folder inside OperaLibre. Already have a library? Type its full folder path instead. At Audiobook folder, press Return to use the default, or enter the full path of your existing library folder. ## 00:01:04 — Allow your phone to connect. For this walkthrough, choose lan on your trusted home network. Prompt: `Choose local or lan [local]:` Example answer: `lan` Type lan, then press Return. local limits access to this computer. lan allows your home devices. The default is local. To connect a phone on your trusted home network, type lan and press Return. Access away from home comes later, in the Tailscale steps. ## 00:01:18 — Create the library folder, if asked. This question appears only when the folder does not exist. Prompt: `/Users/you/OperaLibre/audiobooks does not exist. Create it? [Y/n]:` Example answer: `Return` Return creates the folder you selected. If you choose n, setup stops. Rerun with an existing folder. If your chosen audiobook folder does not exist, the installer asks to create it. Return accepts yes. Choosing no stops this installation. ## 00:01:28 — Enable the Audible import. Libation lets OperaLibre import your Audible purchases. Prompt: `Set up the Audible import now? [y/N]:` Example answer: `y` Type y, then press Return to follow this guide. You sign in to Audible later, inside OperaLibre. Return or n skips the import. At Set up the Audible import now, type y and press Return. The default is no. The installer only prepares Libation; you connect your Audible account in OperaLibre after creating your account. ## 00:01:42 — Install or reuse Libation. The installer finds Libation, or offers to download it. Prompt: `Download Libation from its official GitHub release? [Y/n]:` Example answer: `Return` If it finds Libation, answer Use it? with Return. Otherwise, Return accepts the official download. Wait for it to finish. If Libation is found, press Return at Use it. Otherwise, press Return to download its official release, about 90 MB. Libation is placed inside your OperaLibre folder; nothing is installed system-wide. ## 00:01:58 — An extra Linux question. Some Linux computers need the ICU runtime for Libation. Prompt: `Install the ICU runtime now? [Y/n]:` Example answer: `Return` Return accepts installation through your package manager. It may ask for administrator access. Skipping it leaves Audible unavailable. On Linux only, a missing ICU runtime triggers this question. Installing it may require administrator access. Without it, Audible remains unavailable; OperaLibre still installs. ## 00:02:10 — If automatic setup cannot finish. You may see a request for an existing Libation program. Prompt: `Path to an installed Libation command-line program (blank to skip) []:` Example answer: `Return` If you know the executable’s full path, enter it. Otherwise, Return skips Audible for now. The installer still finishes. If Libation was not configured, the installer may ask for its command-line program path. Enter a known executable path, or press Return to skip Audible. ## 00:02:22 — Installation finished. The installer starts OperaLibre and prints its address. Note the localhost address and the Start and Stop launchers. Audible sign-in is no longer in Terminal. You connect it in OperaLibre, after creating your account. When the installer prints Done, OperaLibre is running at the printed localhost address. It also lists the Start and Stop launchers and the settings file. If you set up the Audible import, connect your Audible account later inside OperaLibre. ## 00:02:36 — Choose your server URL. Home Wi-Fi works as is. Tailscale, next, adds access away from home. On the server, use the localhost URL printed by the installer. For a phone, find the server’s IPv4 in its network settings and add :4920. Tailscale comes next: optional, but we recommend it. First choose how you will reach your server. On the server computer, use the localhost URL printed by the installer. On another device, use the server’s home-network IP and port. The next steps set up Tailscale for access away from home. They are optional, but we recommend them. ## 00:02:56 — Connect the server and phone. Tailscale is optional, but we recommend it. It lets your phone reach your library away from home. Install it on both devices. Home Wi-Fi only? Skip ahead to Create your OperaLibre account. Tailscale connects your server and phone privately over the internet, so your library works away from home. It is optional, but we recommend it. Set it up on both devices with the same Tailscale account. If you only listen on home Wi-Fi, skip ahead to Create your OperaLibre account. ## 00:03:14 — Confirm LAN mode. If you chose LAN in the installer, continue to the next step. If you chose local-only, open the install folder and stop OperaLibre with its stop launcher. Edit server.config: set deployment_mode to lan, clear host, save, then run the start launcher. On your server, check the mode you chose in the installer. If it was LAN, continue. If it was local-only, stop OperaLibre using the stop launcher in its install folder. Edit server.config, set deployment_mode = lan and leave host empty. Save, then run the start launcher. ## 00:03:34 — Install Tailscale on the server. Choose the instructions for your server: Mac or Linux. Mac: download the standalone app at tailscale.com/download. Open it and allow VPN setup. Linux: run the two commands shown. Open the login link printed by the second command. Choose one installation method for your server. On Mac, download the standalone Tailscale app, install it, open it and allow VPN setup. On Linux, run the official install command, then sudo tailscale up, and open its printed login link. ## 00:03:54 — Sign in on the server. Choose a sign-in provider, such as Google, and your account. Complete the Tailscale setup questions. Wait until the server shows Connected. Remember the provider and email you used. You will use both on your phone. Sign in to Tailscale on the server. Choose a provider, such as Google, and complete any setup questions. Wait for Connected. Remember the provider and account email: use exactly the same ones when signing in on your phone. ## 00:04:10 — Install Tailscale on the phone. Get the iPhone app from the App Store and tap Get Started. Accept the request to add VPN configurations. Allow notifications for sign-in reminders, then choose Log in. On your phone, install Tailscale from the App Store. Open it and tap Get Started. Allow the VPN configuration and notifications for sign-in reminders. Choose Log in. ## 00:04:24 — Use the same Tailscale account. On the phone, choose the same provider and email as the server. For example: Google on the server means Google with the same email on the phone. Wait for Connected. Both devices must be in the same Tailscale network. Log in on your phone with the same provider and account email you used on the server. Wait for Connected. This puts the devices in the same private Tailscale network. ## 00:04:40 — Copy the server’s Tailscale IP. Find your server in Tailscale’s device list. Select the computer running OperaLibre, not the phone. Copy its 100.x.x.x IP. The names and numbers here are examples. Open the Tailscale device list or the Machines page in its admin console. Find the computer running OperaLibre and copy its Tailscale IP. Do not copy the phone’s IP. The server address shown here is an example. ## 00:04:56 — Turn the IP into a URL. Add http:// before the server IP and :4920 after it. Example: http://100.80.10.20:4920 Replace the example IP with your server IP. Use your configured port if it is not 4920. Build your OperaLibre URL using http://, your server’s Tailscale IP, a colon, and the OperaLibre port. For example, http://100.80.10.20:4920. Use your own server IP and configured port. Keep this URL for the browser and app. ## 00:05:12 — Open the URL on your phone. Keep Tailscale connected and enter the URL in Safari. You should see OperaLibre’s Claim this library screen. If it does not load, check the server is on, OperaLibre is running, and both devices show Connected. With Tailscale connected on your phone, open your server URL in Safari. OperaLibre should show Claim this library. If it does not load, check the server is awake, OperaLibre is running in LAN mode, and the address and port are correct. Then check the firewall or Tailscale access rules if needed. ## 00:05:30 — Now create your owner account. Your server URL is ready. Account setup is next. Tailscale setup is complete when the OperaLibre page loads. Create your OperaLibre account next. Later, enter this same server URL in the app. When your OperaLibre page loads, Tailscale setup is complete. Next, create your owner account. Then connect the OperaLibre app using the same server URL. ## 00:05:42 — Create your OperaLibre account. Open your chosen URL, then select Create owner. Choose a username and a password of at least 12 characters. Confirm the password. This OperaLibre account is separate from Amazon and Tailscale. Open your chosen server URL in a browser. In Claim this library, enter a username, a password of at least 12 characters, and the matching confirmation. Choose Create owner. Use this OperaLibre account to sign in on your other devices. ## 00:05:56 — Open Audible in OperaLibre. Signed in as the owner, choose Get books, then Audible. Choose Connect next to Connect Audible. Connect stays unavailable while OperaLibre checks Libation on the server. Give it a moment. Signed in as the owner, open Get books and choose the Audible tab. Next to Connect Audible, choose Connect. If you skipped the Audible import in the installer, the Audible tab does not appear; the Libation guide explains how to turn it on later. ## 00:06:10 — Enter your Audible account. Name it, enter your Audible email, then choose the store. Use a label such as Personal. Enter the email of the Amazon account you use with Audible. Choose the Marketplace where you bought your books. It can differ from where you live. In Connect Audible, enter an account label such as Personal, the email or login for your Audible account, and the Marketplace where you bought your books. The email shown is a placeholder. Choose Continue to Amazon. OperaLibre never asks for your Amazon password. ## 00:06:26 — Open Amazon sign-in. OperaLibre opens Amazon’s page in a new browser tab. Choose Open Amazon sign-in. Keep the OperaLibre tab open. Finish within ten minutes. An unfinished sign-in expires, and you can start again. Choose Open Amazon sign-in. Amazon opens in a new tab. Keep the OperaLibre tab open: you will return to it with the final address. An unfinished sign-in expires after ten minutes. ## 00:06:40 — Confirm your Amazon email. Use the Amazon account that holds your Audible purchases. Enter your account email, then choose Continue. The email on screen is a demo address. Amazon may already know your account. On Amazon’s sign-in page, enter the email for your Audible account and choose Continue. This illustration uses a demo address. ## 00:06:52 — Enter your password on Amazon. Keep your password in Amazon’s browser page. Enter your password and choose Sign in. Amazon may instead offer a passkey or another sign-in method. Follow its page. If Amazon asks for a password, enter it on Amazon’s page and choose Sign in. The password is masked in this demo. Your account may offer another sign-in method. ## 00:07:04 — Complete verification, if asked. Use the code or approval that Amazon requests. Enter the code from your own phone or authenticator. Choose Sign in. 000000 is a demo code, not a working code. Your verification screen may differ. If Amazon requests two-step verification, use the code from your phone or authenticator, or follow its approval instructions. The code shown is a non-working example. ## 00:07:18 — Copy the final browser address. After sign-in, select the whole address bar and copy it. Mac: Cmd+L, then Cmd+C. Linux: Ctrl+L, then Ctrl+C. A blank page or one that cannot open is normal. Copy its address; keep it private. After signing in, copy the entire final address from the browser’s address bar. Amazon may show a blank page or say the page cannot open. That is normal. Do not share this private address. ## 00:07:34 — Paste it into OperaLibre. Return to the OperaLibre tab to finish connecting. Paste the full address into the box, then choose Finish connecting. If it fails, choose Cancel sign-in and connect again. Never share this address. Switch back to the OperaLibre tab. Paste the full final address into Paste the final sign-in address, then choose Finish connecting. Libation completes the connection; this can take a moment. The demonstration uses a placeholder, not a real sign-in address. ## 00:07:48 — Add your Audible books. Your purchases appear once Audible is connected. Choose Add to server for a title to put it in your OperaLibre library. Purchases refresh in the background. Choose Refresh purchases to check now. OperaLibre shows Audible connected. Your purchases are refreshing. Choose Add to server for a title to add it to your OperaLibre library. Connecting does not download every book. Manage holds Add all purchases to server and automatic imports. ## 00:08:04 — Connect your iPhone or iPad. Get OperaLibre from the App Store, then enter your server address. Choose OperaLibre. Enter the server IP and port from the URL step, then tap Test & connect. Sign in with the owner account you just created. For Tailscale, keep it connected on both devices. Install OperaLibre on your iPhone or iPad. In Find your library, choose OperaLibre and enter your server address, including the port. Use its home-network IP on the same Wi-Fi, or its Tailscale IP with Tailscale connected. Tap Test & connect, then sign in with your OperaLibre owner account. ## 00:08:20 — Your books are ready to play. Keep the server on while you stream to your devices. Pick a book and press play. Keep the server awake and online. Using Tailscale? Turn off phone Wi-Fi and try playback on cellular. Pick a book and press play. Keep the server awake and online. If you set up Tailscale, leave it connected on both devices, turn off Wi-Fi on the phone, and test playback on cellular. ## Notes This is a silent, illustrated first-install walkthrough. All emails, usernames, paths and addresses shown are examples. No real Amazon account, verification code or return URL is recorded. Amazon and Libation screens can vary. The installer questions need an interactive Terminal. Do not add --yes when following along; --yes accepts every default, which skips the Audible import. If run as root, the installer may ask Continue as root anyway? [y/N]. Decline and rerun as a regular user. Existing installations may instead ask to update and preserve their existing account configuration. Downloads and checksum verification occur between folder selection and optional Audible setup. The installer only prepares Libation. Audible sign-in happens in OperaLibre, under Get books, Audible, after the owner account is created. An unfinished sign-in expires after ten minutes. Conditional screens in the video are labeled. Setup is edited for clarity and does not show download wait times. The Tailscale steps are optional, but we recommend them for listening away from home. Their device names and IP addresses are examples. Choose the Mac or Linux method on the server installation screen. Tailscale and OperaLibre use separate accounts. No router port forwarding is needed for this direct private device connection. After creating the owner account and connecting the app, test playback on cellular. ## Installation command ```sh curl -fsSL https://raw.githubusercontent.com/DonovanMontoya/OperaLibre/main/script/install.sh | sh ``` ## Tailscale commands for a Linux server ```sh curl -fsSL https://tailscale.com/install.sh | sh sudo tailscale up ``` ## Sources Installer and docs retrieved 2026-10-28, matching release 0.5.0. - https://github.com/DonovanMontoya/OperaLibre/blob/main/script/install.sh - https://github.com/DonovanMontoya/OperaLibre/blob/main/docs/installing-a-release.md - https://github.com/DonovanMontoya/OperaLibre/blob/main/docs/libation.md - https://donovanmontoya.github.io/OperaLibre/deployment.html - https://apps.apple.com/app/operalibre/id6792065037 - https://spcentral.amazon.com/ - https://digprjsurvey.amazon.com/csad/help/node/G3PWZPU52FKN7PW4 - https://github.com/DonovanMontoya/OperaLibre/blob/main/apps/web/src/Auth.tsx - https://github.com/DonovanMontoya/OperaLibre/blob/main/apps/web/src/LibraryPane.tsx - https://github.com/DonovanMontoya/OperaLibre/blob/main/apps/web/src/AudibleManagement.tsx - https://tailscale.com/docs/how-to/quickstart - https://tailscale.com/docs/install/mac - https://tailscale.com/docs/install/linux - https://tailscale.com/docs/install/ios - https://tailscale.com/docs/how-to/connect-to-devices Amazon illustrations follow the inspected public email-first form, with separate password and example verification screens. Their controls are animated recreations, not live authentication recordings. The email-first screen was inspected through the browser on 2026-10-03. Terminal scenes quote the installer script. OperaLibre screens, including the Connect Audible dialog, are drawn from the labels, layout and colours in Auth.tsx, LibraryPane.tsx, AudibleManagement.tsx and styles.css at release 0.5.0. Tailscale screens are illustrations.