Skip to content

Latest commit

 

History

History
79 lines (52 loc) · 2.83 KB

File metadata and controls

79 lines (52 loc) · 2.83 KB

GitHub release issues - python-freejay test License Code style: black

Python FreeJay

Python FreeJay is an open source DJ application that supports basic DJ functionality and convenient audio download from YouTube.

Inspired by the 2000s party saver twoyoutubevideosandamotherfuckingcrossfader.com, FreeJay is a desktop application built on open source tools, and aims to provide a fast and painless solution for those times when all you have is a laptop and an internet connection.

Project Status

Project is: in progress

Roadmap

The project is currently under development and various design decisions are yet to be made. The core functionality will be built on the standard logic used in mainstream DJ software.

Initial release:

The initial release will provide a basic GUI built using tkinter with audio playback implemented using python-mpv.

Features:

  • 2 decks (audio players)
  • Crossfader
  • Play/pause, cue, stop, pitch, nudge, jog
  • YouTube audio download

Further down the line...

  • 3-band EQ per channel/deck
  • Waveform visualisation
  • TUI, eventually replacing the tkinter GUI.
  • BPM detection

Installation

This project is still in development and is not ready for distribution. Install instructions will be provided with initial release.

If you are interested in viewing the progress so far, you can try the following:

  • I'm running Python 3.11.0, though earlier versions may work
  • Clone this repository
  • Install dependencies using pip install -r requirements.txt
  • Install libmpv. If you encounter difficulties check the install instructions for python-mpv

Usage

This project is still in development and is not ready for distribution. Usage instructions will be provided with initial release.

Contributing

Not accepting code contributions until a basic application structure has been established. Please feel free to submit suggestions via an enhancement New feature or request issue.

Code Style

Black

License

GPLv3 or later.