Skip to content

feat: Implement teal.fm as source/client#389

Merged
FoxxMD merged 18 commits intomasterfrom
tealfm
Nov 11, 2025
Merged

feat: Implement teal.fm as source/client#389
FoxxMD merged 18 commits intomasterfrom
tealfm

Conversation

@FoxxMD
Copy link
Copy Markdown
Owner

@FoxxMD FoxxMD commented Nov 7, 2025

Checklist before requesting a review

Type of change

Please delete options that are not relevant.

  • New feature (non-breaking change which adds functionality)
  • This change requires a documentation update

Describe your changes

  • Implement scrobbling to atproto networks/PDS using teal.fm collection/records
  • Implement Source for teal.fm collection/records

Issue number and link, if applicable

#378

@FoxxMD FoxxMD added enhancement New feature or request safe to test trusted to build image labels Nov 7, 2025
@FoxxMD
Copy link
Copy Markdown
Owner Author

FoxxMD commented Nov 7, 2025

Setup with Bluesky

  • Create a Bluesky account, if you don't already have one
  • Navigate to https://bsky.app/settings/app-passwords
    • Settings -> Privacy and Security -> App passwords
  • Create a new App Password and save it somewhere, it will not be shown again

Handle

The handle used with multi-scrobbler should be your full ATProto handle, including TLD.

  • For regular Bluesky account this will be like: alice.bsky.social
  • For Bluesky accounts that use their website as their account this is your domain: mydomain.com
  • For non-Bluesky users, you probably already know your handle

If you do not include a TLD then multi-scrobbler will automatically append .bsky.social to your handle value.

Configuration

With ENV

As a Scrobble Client with ENV config

Environmental Variable Required? Default Description
TEALFM_IDENTIFIER Yes Your full ATProto handle. For Bluesky account this is like myUser.bsky.social
TEALFM_APP_PW Yes Bluesky/ATProto network App Password

With File

For either Source/Client as a file config

CONFIG_DIR/tealfm.json

[
    {
        "name": "myTeal",
        "configureAs": "client",
        "data": {
            "identifier": "alice.bsky.social",
            "appPassword": "twog-phu7-4dhe-y4j3"
        },
    },
        {
        "name": "myTealSource",
        "configureAs": "source",
        "data": {
            "identifier": "alice.bsky.social",
            "appPassword": "twog-phu7-4dhe-y4j3"
        }
    }
]

@FoxxMD FoxxMD changed the title Tealfm feat: Implement teal.fm as source/client Nov 7, 2025
@FoxxMD FoxxMD linked an issue Nov 7, 2025 that may be closed by this pull request
4 tasks
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Nov 7, 2025

📦 A new release has been made for this pull request.

To play around with this PR, pull an image:

  • foxxmd/multi-scrobbler:pr-389

Images are available for x86_64 and ARM64.

Latest commit: a429bcc

@FoxxMD FoxxMD merged commit a094a1a into master Nov 11, 2025
6 checks passed
@FoxxMD
Copy link
Copy Markdown
Owner Author

FoxxMD commented Nov 13, 2025

This PR is included in the 0.10.2 release and latest or 0.10.2 docker image tag.

@FoxxMD FoxxMD deleted the tealfm branch March 31, 2026 19:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request safe to test trusted to build image

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat: Add teal.fm as scrobble client

1 participant