ABS Wear

Generated by the Very Good CLI 🤖

Audiobookshelf on your Android Wear!

About

ABS Wear is a standalone version for Android Wear OS 4.0, currently there is no plan to develop a version for Watch OS (Apple). This project is made for fun as a weekend project. This project is not part of the audiobookshelf core as it is written in Flutter instead of Vue. ABS Wear is a 3rd party project and is not affiliated with the original project.

Download the app from Play Store: ⌚ ABS Wear ⌚

Features

• Library: Browse your library and continue listening to your favorite audiobooks.
• Player: Control the playback of your audiobooks.
• Online Mode: Stream your audiobooks from the server (internet connection is required).
• Local Mode: Download your audiobooks and listen to them locally (internet connection is still required for syncing).
• Controls: Control the playback of your audiobooks with the built-in media controls.

Installing GitHub Releases 📦

[!NOTE] There are different types of APK files for Wear OS, depending on the device’s architecture and features. The most common ones are:

app-production-arm64-v8a-release.apk: This is for devices that use a 64-bit ARM processor, such as the Fossil Gen 5, TicWatch Pro 3, and Samsung Galaxy Watch 4.

app-production-armeabi-v7a-release.apk: This is for devices that use a 32-bit ARM processor, such as the Moto 360 (3rd Gen), TicWatch E2, and Fossil Sport.

app-production-x86_64-release.apk: This is for devices that use a 64-bit Intel processor, such as the LG Watch Urbane 2nd Edition and Asus ZenWatch 3.

To install the latest release from GitHub, follow the steps below:

1. Download the latest release from the releases page.

2. Connect your Android Wear device to your computer.

   # Check if the device is connected
   adb devices
   # connect to the device, example:
   adb connect 192.168.1.45:33553
   

3. Open a terminal and navigate to the directory where you downloaded the APK.

   # Example
   cd ~/Downloads
   

4. Install the APK using the Android Debug Bridge (ADB) tool. If you haven't installed ADB, you can download it from the Android developer site.

   # Install the APK
   adb install abs_wear.apk
   # Disconnect from the device
   adb disconnect
   

Getting Started 🚀

This project contains 3 flavors:

• development
• staging
• production

To run the desired flavor either use the launch configuration in VSCode/Android Studio or use the following commands:

# Development
$ flutter run --flavor development --target lib/main_development.dart

# Staging
$ flutter run --flavor staging --target lib/main_staging.dart

# Production
$ flutter run --flavor production --target lib/main_production.dart

*This template includes only the Android runner, as it is meant to run on Wear OS devices only.

Running Tests 🧪

To run all unit and widget tests use the following command:

flutter test --coverage --test-randomize-ordering-seed random

Working with Translations 🌐

This project relies on flutter_localizations and follows the official internationalization guide for Flutter.

Adding Strings

1. To add a new localizable string, open the app_en.arb file at lib/l10n/arb/app_en.arb.

   {
       "@@locale": "en",
       "serverUrlLabel": "Server URL",
       "@serverUrlLabel": {
           "description": "Label for the server URL input field"
       },
       "usernameLabel": "Username",
       "@usernameLabel": {
           "description": "Username for the input field"
       },
       "passwordLabel": "Password",
       "@passwordLabel": {
           "description": "Password for the input field"
       },
       "hello": "Hello {username}",
       "@hello": {
           "description": "Hello text with parameter: username",
           "placeholders": {
               "username": {
                   "type": "String",
                   "example": "Bob"
               }
           }
       }
   }
   

2. Then add a new key/value and description

   {
       "@@locale": "en",
       "serverUrlLabel": "Server URL",
       "@serverUrlLabel": {
           "description": "Label for the server URL input field"
       },
       "usernameLabel": "Username",
       "@usernameLabel": {
           "description": "Username for the input field"
       },
       "passwordLabel": "Password",
       "@passwordLabel": {
           "description": "Password for the input field"
       },
       "hello": "Hello {username}",
       "@hello": {
           "description": "Hello text with parameter: username",
           "placeholders": {
               "username": {
                   "type": "String",
                   "example": "Bob"
               }
           }
       },
       "library": "Library",
       "@library": {
           "description": "Text for Library"
       }
   }
   

3. Use the new string

   import 'package:abs_wear/l10n/l10n.dart';
   
   @override
   Widget build(BuildContext context) {
   final l10n = context.l10n;
   return Text(l10n.library);
   }
   

Special thanks 😊

• advplyr - Author of Audiobookshelf
• nyxholas - Moderator/Contributor of ABS