Loudline docs
v1.0.0
DemoDemo console Get help
● Ship

Troubleshooting
common problems and fixes.

Cases from the code and the build, with what to check.

filesaudiopurchasesserverbuild

01"Cannot open this file"

The phone's own codec could not read the file. Copy-protected files cannot be read. Some formats the phone cannot decode will not open either. Try another file type, or convert the file with another tool first. Remember that the codec bridges have not been run on a real device by the author: if every file fails, check the platform log (flutter logs) and see First device test.

02"This file is over the limit" or "Files over N minutes need Pro"

The first is the file limit for everyone (default 500 MB and 240 minutes), set in the console under App config: file limits. The second is the length allowed without Pro (default 10 minutes), set under App config: paywall. The third message, about the daily copies, says how many a user may make a day (default 3).

03A video gives an audio file

By design: the app reads the audio of a video and exports an audio file. The picture is not put back in. If "Video files are switched off in this build" appears, the video input switch is off in the console.

04A file with more than two channels

Only mono and stereo are supported. More channels are reduced to the first two.

05The copy is not as loud as the target

The app says "the target could not be reached without going over the peak ceiling". A lower target or a higher ceiling gets closer. If the original was already clipped, a louder copy cannot undo that.

06The copy sounds noisier

When the noise sits close to the voice (under 12 dB), raising the level raises the noise too, and the app warns about it. Switch on noise reduction or lower the target. Noise reduction needs about half a second of pause or hiss to learn from; if there is none, nothing is removed.

07iPhone: Loudline is not in the share sheet

This version has no iOS Share Extension. It appears under Open in for audio and movie files, for example from Files or a Voice Memos export. A full Share Extension needs its own target, app group and signing.

08Android: shared files do not arrive

The app accepts Share and Open with for audio and video through intent filters in AndroidManifest.xml. If you renamed the package, the channel name in brand.dart must match MainActivity.kt and AudioCodec.kt, and the Kotlin folder and package lines must match the new application id (Rename).

09The paywall says purchases are not set up

No product id is set for this platform. Fill the ids in brand.dart or the console (Where to put the ids). Ids must match App Store Connect and Play Console exactly.

10Products are set but the store returns nothing

iOS: the Paid Apps agreement and tax forms must be complete and the product ready to submit. Android: the app must be installed from a Play test track (not a sideloaded APK) by a licence tester, and the product and base plan must be active. Wait some hours after creating products.

11Purchase verification answers 501

501 verification_off means verification is not switched on in the console, so the app trusts the on-device result. Turn it on under Purchases and fill in the credentials.

12Google Play verification fails with a permission error

The service account must be invited in Play Console with View app information and View financial data, and the Android Publisher API must be enabled in the Google Cloud project. New permissions can take some time to apply.

13App Store lookup fails

Check the bundle id, Key ID, Issuer ID, and that the .p8 text was pasted whole including its BEGIN and END lines. The server tries Production, then Sandbox.

14I cannot find the console setup code

It is printed in the server log at start when ADMIN_SETUP_TOKEN is empty. In Docker run docker logs. Or set ADMIN_SETUP_TOKEN in .env and restart.

15npm ci fails or better-sqlite3 will not load

Use Node 22.12 or newer (node -v). better-sqlite3 is a native module: if no prebuilt file exists for your system, you need build tools (Python 3, make, a C++ compiler). Delete node_modules and run npm ci again after changing Node versions.

16429 errors, or everyone shares one address

/v1 routes allow 60 requests a minute per address. Behind a proxy set TRUST_PROXY_HOPS=1, otherwise all users look like the proxy's address.

17A console change does not appear in the app

The config is cached for 5 minutes and by ETag. Wait, then reopen the app. Check the app was built with API_BASE_URL and that the address is https and reachable from the phone.

18Play rejects the upload or says the app is debug-signed

As shipped, release builds use the debug key. Add your own signing config (Release).

19Xcode says signing failed or the bundle id is not available

The project ships with no team set. Choose your own team and a bundle id you own (Rename).