Libre Voice Note App - Server Setup Guide

Follow this comprehensive guide to set up your Voice Note server on Windows. This guide will walk you through the installation process, configuration, and connection with your mobile app.

1. Installation

1.1 Download and Extract

First, download the server package from the downloads page. Once downloaded, extract the ZIP file to a location of your choice. We recommend using a path without spaces, such as:

C:\VoiceNoteServer\

1.2 Run the Installer

Navigate to the extracted folder and run the setup.exe file as an administrator. This will install all necessary dependencies and set up the server environment.

The installer will check for the following requirements:

  • Python 3.8 or higher
  • .NET Framework 4.7.2 or higher
  • Required disk space

If any requirements are missing, the installer will guide you through installing them.

1.3 Verify Installation

After installation completes, verify that the server was installed correctly by opening the Voice Note Server Manager from your Start menu or desktop shortcut.

2. Server Configuration

2.1 Basic Configuration

Open the Server Manager and navigate to the "Settings" tab. Here you can configure:

  • HTTP Port (default: 80)
  • HTTPS Port (default: 443)
  • Logging Level
  • Storage Location

2.2 User Management

Go to the "Users" tab to create administrator and user accounts. At minimum, create one administrator account that will be used for server management.

Note: By default, new user registration is disabled. You can enable it in the Security settings if you want to allow users to create their own accounts.

3. SSL Certificate Setup

3.1 Generate Self-Signed Certificate

For secure communication, the server requires an SSL certificate. You can generate a self-signed certificate using the built-in tool:

  1. Go to the "Security" tab in Server Manager
  2. Click "Generate New Certificate"
  3. Enter your server's IP address or domain name
  4. Click "Generate"

3.2 Using Existing Certificates

If you have an existing SSL certificate, you can import it:

  1. Go to the "Security" tab
  2. Click "Import Certificate"
  3. Select your certificate files (.crt and .key)
  4. Click "Import"

4. Whisper AI Setup

4.1 Select Transcription Model

The server uses OpenAI's Whisper for voice transcription. You can select the model size based on your server's capabilities:

  • tiny: Fastest, lowest accuracy, minimal resource usage
  • base: Fast with decent accuracy
  • small: Good balance of speed and accuracy (recommended)
  • medium: High accuracy, moderate resource usage
  • large: Highest accuracy, significant resource usage

Go to the "Transcription" tab and select your preferred model.

4.2 Download Model

Click "Download Model" to download the selected Whisper model. This may take some time depending on your internet connection and the model size.

Note: The large model requires at least 8GB of RAM and 10GB of disk space.

5. Connect Mobile App

5.1 Server Information

Once your server is configured, you'll need the following information to connect your mobile app:

  • Server IP address or domain name
  • HTTPS port (default: 443)
  • Username and password

You can find your server's IP address in the "Information" tab of the Server Manager.

5.2 Mobile App Setup

On your Android device:

  1. Install the Libre Voice Note App from Google Play
  2. Open the app and go to Settings
  3. Select "Server Connection"
  4. Enter your server information
  5. Tap "Test Connection" to verify

If the connection is successful, your app is now ready to sync with your server.

Troubleshooting

Connection Issues

If your mobile app cannot connect to the server:

  • Verify that the server is running (check Server Manager)
  • Ensure your firewall allows connections on your HTTPS port
  • Check that the certificate is valid and trusted
  • Verify that your mobile device and server are on the same network

Transcription Issues

If voice notes aren't being transcribed:

  • Check that the Whisper model was downloaded successfully
  • Verify your server has sufficient resources
  • Check the logs for any errors (in the "Logs" tab)

Common Errors

Here are solutions to common errors:

  • "Certificate not trusted": Import the server's certificate on your mobile device
  • "Failed to start transcription service": Ensure Python is properly installed and try a smaller Whisper model
  • "Database error": Verify the database path is writable