whatisgithub

What is timber?

naman14/timber — explained in plain English

Analysis updated 2026-06-22

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

In one sentence

An open-source Android music player with Material Design, playlist management, LastFM scrobbling, and home screen widgets, no longer maintained, kept as a historical reference or starting point.

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
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

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.

What is it built with?

JavaAndroid

How does it compare?

naman14/timberjakewharton/actionbarsherlockjunit-team/junit-framework
Stars7,0507,0637,024
LanguageJavaJavaJava
Setup difficultymoderatemoderateeasy
Complexity3/52/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get 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.

So what is it?

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?

Frequently asked questions

What is timber?

An open-source Android music player with Material Design, playlist management, LastFM scrobbling, and home screen widgets, no longer maintained, kept as a historical reference or starting point.

What language is timber written in?

Mainly Java. The stack also includes Java, Android.

What license does timber use?

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

How hard is timber to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is timber for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.