view release on metacpan or  search on metacpan

README.md  view on Meta::CPAN

# DrivePlayer

A GTK3 desktop music player that streams audio files stored in Google Drive.

## Features

- Streams audio directly from Google Drive via mpv
- Local SQLite library of scanned folders and tracks
- Sidebar navigation by artist, album, genre, or folder
- Metadata enrichment via iTunes, MusicBrainz, and AcoustID fingerprinting
- Google Sheets sync for portable metadata across multiple devices
- Incremental folder sync (adds new files, removes deleted ones)
- OAuth2 authentication via Google::RestApi

## Requirements

### System packages

```
sudo apt-get install build-essential pkg-config libssl-dev mpv \
    libgtk-3-dev libglib2.0-dev libgirepository1.0-dev gir1.2-gtk-3.0
```

### CPAN dependencies

```
cpanm --installdeps .
```

Or install everything in one step:

```
make install
```

## Setup

### 1. Create Google Cloud credentials

1. Go to [Google Cloud Console](https://console.cloud.google.com/) and create a project
2. Enable the **Google Drive API**: APIs & Services → Enable APIs → search "Drive API"
3. Create OAuth credentials: APIs & Services → Credentials → Create Credentials → OAuth client ID → **Desktop app**
4. Note the **Client ID** and **Client Secret**

### 2. Configure the application

Launch the app, open **File → Settings**, and paste the Client ID and Client Secret. Click Save.

The config file is written to `~/.config/drive_player/config.yaml`.

### 3. Authorise access to Google Drive

```
google_restapi_oauth_token_creator
```

Follow the prompts. The token is stored at `~/.config/drive_player/token.dat` by default.

### 4. Add music folders

Open **File → Manage Folders** and add the Google Drive folder ID (the last
path component of the folder's Drive URL) and a display name.