naman14/timber

★ 7,050JavaAudience · developerComplexity · 3/5LicenseSetup · moderate

Mindmap

mindmap
  root((repo))
    What it does
      Android music player
      Material Design UI
    Features
      Playlists 6 themes
      LastFM scrobbling
    Integrations
      Android Wear Auto
      Chromecast support
    Status
      No longer maintained
      GPL v3 license

mindmap root((repo)) What it does Android music player Material Design UI Features Playlists 6 themes LastFM scrobbling Integrations Android Wear Auto Chromecast support Status No longer maintained GPL v3 license

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Use as a reference codebase when building an Android music player with Material Design.

USE CASE 2

Fork and customize the source for a personal or educational Android project studying audio playback.

USE CASE 3

Study how Android integrations like LastFM scrobbling, Chromecast, Android Auto, and Wear are implemented together.

Tech stack

JavaAndroid

Getting it running

Difficulty · moderate Time to first run · 1h+

Project is no longer maintained and may require fixes for newer Android versions, the developer recommends TimberX instead.

Free to use, modify, and distribute under GPL v3, but any distributed derivative must also be open-source under the same license.

In plain English

Timber is an Android music player app built around Material Design, Google's visual style system for mobile interfaces. It was created by an independent developer and published as open-source software. The project is no longer actively maintained, the developer has moved to a newer version called TimberX, so Timber should be treated as a historical reference or starting point rather than a current, supported product. The app lets users browse their device's local music library by song, album, or artist. Users can build and edit playlists, and there are six different visual styles for the now playing screen, so the listening view can be changed to match personal preference. Home screen widgets let users control playback without opening the app, and folder browsing allows digging into the device's file system directly to find music that is not properly tagged. Timber includes a dark theme and additional options for customizing the interface. Gestures can be configured for switching tracks. The app connects to LastFM to log what you listen to, a practice called scrobbling. It supports Android Wear smartwatches and Android Auto, the in-car Android interface, so playback can be controlled from those surfaces too. Chromecast support means audio can be sent to a compatible speaker or TV. Lyrics are displayed inside the app. A notification queue feature, which requires Xposed (a system-level Android framework), shows the upcoming track list in the notification shade. Because this project is no longer in active development, it will not receive bug fixes or updates for newer Android versions. The developer's newer project, TimberX, is the recommended path for anyone wanting a similar music player that is still being maintained. The code is released under the GNU General Public License version 3.

Copy-paste prompts

Prompt 1

Using Timber as a reference, show me how to implement a now-playing screen in Android with multiple visual themes the user can switch between.

Prompt 2

How does Timber implement LastFM scrobbling in an Android music app? Show me the relevant integration pattern.

Prompt 3

Based on the Timber codebase structure, how should I organize an Android music player app with browsing by song, album, and artist?

Prompt 4

How do I add Chromecast and Android Auto support to an Android media player app, using Timber as a reference?

Open on GitHub → Explain another repo

← naman14 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.