Coding soon

Coding soon

Flaque

Download & share high quality music and more from any device or browser

About

Flaque is a simple media downloader.
Run your own instance at home, make it accessible from outside, share content with friends and family.

  • Download lossless files from Qobuz and Tidal
  • Unlock links and fast download via AllDebrid
  • Orders queue, no hurry, processed one by one
  • Email download link after order is processed
  • Delete email address once order is completed

No ads, no download manager, command lines, torrents, transfer, drive, etc...

One click drop, wait for delivery, play and share from any device.

Flaque web page

Go to Flaque page, paste link and email.

Text inputs

Flaque bookmark

Click.

Qobuz drop, also works with Tidal
from Alldebrid
Click click click

Flaque to go

Just sharing.

iOs Qobuz drop
Android Qobuz drop

Features

Web player

  • Play & share music from any browser
  • One "music box" per email (hashed)
  • Background audio
  • Native media controls
  • MP3@320 playback
  • Original file download
  • Offline playback [SOON]
  • Playlists [SOON]

Delivery

  • Allow direct open files (flac, pdf, mp4, ...)
  • Or compress all orders and force download
  • Qobuz & Tidal albums zipped with cover & emailed
  • Single tracks are added to web player if enabled

Metadata

  • Extract covers from audio files
  • Extract first page from PDF files (CBR & CBZ [SOON])
  • Parse MKV files and fetch posters from TMDB
  • Attach images to emails
  • Opengraph message previews

Opengraph

Alldebrid download relay

  • {FLAQUE_URL}/dbrd?url={LINK}
  • Waiting line page [SOON]
  • Start download

Privacy

  • No accounts
  • No cookies
  • No analytics
  • No centralized database
  • Not storing email addresses in database
  • Just keeping a hash for download limits
  • Also used by web player to store tracks
  • Collecting IP addresses but also hashed

Security

Not really... just sharing ¯\(ツ)/¯

Flaque setup

🧪 FIRST RELEASE
🚀 NODEJS NO LTS
💥 UNSTABLE TEST
🪲 BUGS INCOMING

☣️ This version is running a Node.js 23.10 EXPERIMENTAL UNSAFE web server with no dependencies (built-in modules only), coded by a machine (and fixed by a human).

Flaque code was developped with a real keyboard, and needs a few npm packages to run.

Underlying server can be easily replaced.

This project was intended for personal use, tested with friends for almost a year now.
Running on a 2016 Intel NUC + Ubuntu server + 1Gbps internet access, uptime and performances are satisfying.
Downloaders get stuck from time to time, error handling is not fully implemented.

Flaque sources

Download repository from Github

Required software

Windows

Self-contained portable autoinstall

⚠️ experimental

Tested on Windows 11 Pro 24H2

  • Open terminal in Flaque directory
  • Run autoinstall script
    ops\scripts\install_win.bat
  • Connect Qobuz account (enter credentials, ignore all settings)
    run.bat qobuz-dl
  • Connect Tidal account (enter credentials, follow instructions)
    run.bat tidal-dl-ng login
  • Edit prod/server.conf.js and prod/flaque.conf.js
  • Start server
    run.bat npm start
  • Go to Flaque page {FLAQUE_URL}/flaque
  • If running locally : http://localhost:8080/flaque

Ubuntu

⚠️ experimental

This script will download and install Node.js 23.10 and configure Python 3.12 virtual environment.
Tested on Ubuntu 24 VM fresh install and Ubuntu 24 WSL2.

  • Open terminal in Flaque directory
  • Make script executable
    chmod +x ./ops/scripts/install_ubuntu.sh
  • Run autoinstall script
    ./ops/scripts/install_ubuntu.sh
  • Open a new terminal
  • Connect Qobuz account (enter credentials, ignore all settings)
    qobuz-dl
  • Connect Tidal account (enter credentials, follow instructions)
    tidal-dl-ng login
  • Start server once to create default config files
    npm start
  • Edit settings in prod directory

Docker

Flaque image is based on node:23.10-alpine.

Two volumes must be mounted to preserve data :

  • /app/prod : Flaque config files and drops directory

  • /root/.config : Qobuz & Tidal config files

  • Open terminal in Flaque directory

  • Create image
    docker compose --file ops/docker/docker-compose.yml build --force-rm --no-cache

  • Create container docker compose // volumes // ports

  • Connect Qobuz account (enter credentials, ignore all settings)
    docker exec -it {container_name} qobuz-dl

  • Connect Tidal account (enter credentials, follow instructions)
    docker exec -it {container_name} tidal-dl-ng login

HTTPS

  • docker reverse
  • let's encrypt
  • win acme

Settings

⚠️ Flaque is open by default. Accepts drops from any email address !

Flaque config
+

Configuration

Web drop

  • Go to Flaque page
  • Paste link
  • Type email
  • Drop

Browser will keep email address in LocalStorage, next pasted links will be submitted automatically.

Bookmark drop

  • Generate bookmarklet code below
  • Data not transfered to server
  • Right click bookmarks bar, Add page ...
  • Choose a fancy name, paste code in URL field
  • Go to Qobuz or Tidal track / album page
  • Click the button

One bookmark = one email address

Mobile drop

Qobuz & Tidal

  • Install apps
  • Create free accounts
  • Choose track or album
  • Tap dots ⋮menu···
  • Share -> More
  • Run shortcut

Alldebrid

  • Open browser
  • Go to supported host link
  • Open share sheet
  • Run shortcut

Shortcuts can be duplicated, renamed, and edited

iOs

  • Install Shortcuts
  • Get shortcut below
  • Run configuration
  • Set Flaque URL and email address

Android

  • Install HTTP Shortcuts
  • Fill form below (not sent to server ;)
  • Set Flaque URL and email address
  • Download shortcut
  • Import in HTTP Shortcuts

URL drop

Simple HTTP GET request
{FLAQUE_URL}/drop?lnk={MEDIA_LINK}&box={EMAIL_ADDRESS}

Optional email custom message
&msg=enjoy the silence when the music's over

Guides [SOON]

  • Self hosting
  • Port redirect
  • Static IP
  • Domain name
  • Dynamic DNS
  • Let's Encrypt
  • Self-signed
  • Py managed env
  • pipx
  • Docker
  • Raspberry
  • ...

How it works

  • Wait for order (link + email address)
  • Validate link, email, status, limits
  • Queue order, processed one by one
  • Download file
  • Process order
    • Parse metadata
    • Extract or fetch image
    • Create archive if needed
  • Move file to user directory
  • Email download link
  • Next order

Database

flaque_drops : orders tracking

  • hash : drop hash
  • date : timestamp
  • www : portal, Qobuz / Tidal / Alldebrid
  • typ : media type, album / track / host
  • uid : keep download links, optional, can be disabled
  • stt : drop state (wait it, load it, parse it, zip it, send it, mail, delete it)
  • box : email address hash
  • ip : ip address hash

flaque_tracks : web player tracks

  • hash : drop hash
  • box : owner email hash
  • file : file name
  • artist : track artist
  • album : track album
  • title : track title
  • dur : track duration
  • ext : file type
  • size : file size
  • samp : sample rate
  • bits : bit depth
  • rate : bitrate
  • tags : custom tags [SOON]

flaque_files : downloaded files

  • hash : drop hash
  • box : owner email hash
  • date: timestamp
  • file : file name
  • ext : file type
  • size : file size

Storage

Flaque drops directory structure

tmp : temporary storage
{email_hash} : user directory
	live : user music library
		{drop_hash}
			lossless flac
			320kbps mp3
			cover jpg
	file : user downloads
		{drop_hash}
			file || archive

Compile

  • Open terminal in Flaque directory
  • Install necessary packages
    npm install google-closure-compiler sass
  • Optional : obfuscate JS code
    npm install javascript-obfuscator
  • Run compilation script npm run compile

Credits

nodejs, nodemailer, archiver, python, qobuz-dl, tidal-dl-ng, alldebrid, music-metadata, tmdb, pdf.js, skr canvas, ffmpeg, fontawesome, waterwave, closure compiler, sass, javascript-obfuscator

Disclaimer

🎓 Educational purposes
🚫 No responsibility
⚠️ Use at your own risks
🎶 Good vibes

〜ヽ(⌐￭_￭)ノ♪♬