Audiobookshelf Integration

I feel like this shouldn’t be too difficult, particularly with the API being so well documented. I just don’t have the programming chops to do it. Anyone feel up to looking into it?



What would you expect it to do? Would it show sessions or library stats, and would it be connected to a particular user or all users?

1 Like

I would love to cast to a google device or wifi speaker.


I’d really love this as well.

It would be nice to be able to connect a user account and then use ha to direct that to media players around the house, just as with other media sources.

looks like someone started developing:

If the developer is reading this, where do you want to go with this integration?

I’d personally really like to see the bookshelf as media source, but even if I like collecting data, I can’t see any other interesting feature.
Of course this would have to work for non-admin users as well to somehow connect the HA user to the ABS user and track the progress.

1 Like

I’ve added a combination of sensors that ultimately returns whether or not a user is listening to media from either AudioBookShelf or Spotify and the book/authur or track/artist currently playing. This is probably a really clunky way to do it, but it works. I don’t know what the real use case for it is, other than just fun. I did it so that my person cards on my dashboards could have headphones on and media info when they’re using either service. Again, not expressly useful, but fun. Code for sensors is below. Basically you create two rest sensors that pull data from ABS via api. One pulls the list of current online users, and the other pulls listening session data for all users. Then there’s a template sensor FOR EACH USER which parses the ABS information and determines if your chosen user is online and if they are, what they’re listening to. Last is another template sensor which checks the ABS template sensor and entities from the spotify integration, to determine if the user is actively listening to either. If the user is not listening at all, the sensor returns not listening. If the user is listening to either service, the sensor returns the appropriate media info.

  - platform: rest
    name: ABS Online Users
    resource: http://(ABS SERVER:PORT)/api/users/online?token=(ROOT USER API TOKEN)
    value_template: "{{ value_json.usersOnline | length }}"
      - usersOnline
    scan_interval: 15

#Rest sensor to get listenings sessions info for all users from ABS via api    
  - platform: rest
    name: ABS User Listening Sessions
    resource: http://(ABS SERVER:PORT)/api/users/(USER ID)/listening-sessions?token=(ROOT USER API TOKEN)
    value_template: "{{ value_json.sessions | length }}"
      - sessions
    scan_interval: 15
# Template sensor for ABS active listening session
    - name: "ABS user Active Session"
      state: >
          {% set user_id = '(USER ID)' %}
          {% set users_online = state_attr('sensor.abs_online_users', 'usersOnline') %}
          {% set sessions = state_attr('sensor.abs_user_listening_sessions', 'sessions') %}
          {% if users_online is not none and sessions is not none %}
            {% set user_online = users_online | selectattr('id', 'equalto', user_id) | list %}
            {% if user_online | length > 0 %}
              {% if sessions | length > 0 %}
                {% set session = sessions[0] %}
                {% if session.mediaMetadata and session.mediaMetadata.authors %}
                  📖 "{{ session.mediaMetadata.title }}" by {{ session.mediaMetadata.authors[0].name }}
                {% else %}
                  Active session with missing media metadata
                {% endif %}
              {% else %}
                No sessions found
              {% endif %}
            {% else %}
              Not Listening
            {% endif %}
          {% else %}
            No data
          {% endif %}
      unique_id: "abs_user_active_session"
# Template sensor for name of media being played by user
    - name: "user Media Playing"
      state: >
          {% set abs_state = states('sensor.abs_user_active_session') %}
          {% set spotify_state = states('media_player.spotify_user') %}
          {% set spotify_title = state_attr('media_player.spotify_user', 'media_title') %}
          {% set spotify_artist = state_attr('media_player.spotify_user', 'media_artist') %}
          {% if abs_state != 'Not Listening' and abs_state != 'unknown' %}
             {{ abs_state }}
          {% elif spotify_state == 'playing' and spotify_title != none and spotify_artist != none %}
            🎵 {{ spotify_title }} - {{ spotify_artist }}
          {% else %}
            Not Listening
          {% endif %}
      unique_id: "user_media_playing"

Sorry for the poor quality gif conversion, but you get the idea.