Skip to content

Latest commit

 

History

History
48 lines (29 loc) · 1.97 KB

README.md

File metadata and controls

48 lines (29 loc) · 1.97 KB
Raw

CI

What is this ?

Intended to run as CLI, it extracts the artwork embedded in audio files (FLAC/MP3) and display it as ascii art.

TLDR

  • Download & extract the bin and the .so (linux x86-64 only. Windows users must compile it themselves, or get a true OS).
  • Run ./flhacker -f /tmp/my.flac
  • Let the magic happen

Example

./flhacker -f ~/Desktop/Time.flac

Example

Why ?

Who knows ?

How does it work ?

  • Uses Spring Boot as base, because life is too short.
  • Uses Jaudiotagger.
  • Uses image-to-ascii.
  • The needed JDK .so are dynamically linked.

Requirements for hacking the codebase

  • Java 21 / maven 3.6+
  • GraalVM 23+ for native image compilation support

GraalVM Native image support

  • Full native image support. Run mvn -Pnative native:compile.
  • Run target/flhacker -f /tmp/my.flac|mp3. Don't forget to escape spaces etc.
  • See the artwork displayed as ascii art in your terminal.

The needed reachabilty metadata are in the src/main/resources/META-INF/native-image folder.

JUST MAKE A FUCKING .EXE FILE AND GIVE IT TO ME

The running executable available in the zip is linux x86-64 only, built on ubuntu-20.04 via GitHub Actions. So, it may not target your OS/CPU/libc architecture.

The best way to be up-to-date is to clone the repo and compile the sources if you know what you are doing (or open an issue).

Also, read this and learn how NOT to be an a$$.