Code Monkey home page Code Monkey logo

athame's Introduction

Buy Me a Coffee at ko-fi.com

Athame is a program for downloading music from music streaming and sharing services. It is intended for educational and private use only, and not as a tool for pirating and distributing music. Above all else, remember that the artists and studios put a lot of work into making music -- if you can, purchase music directly from the artist as more money goes to them.

Since I am also caught up with other things I can't devote all my time to fixing and improving Athame. Right now it is just a very buggy, basic tool which I hope will either be improved upon in the future, or be contributed to.

Download

Click the 'Releases' tab above at the top to download the latest, or just click here.

FAQ

Can you add feature x?

I am currently working on a newer, WPF-based release of Athame which has all of the features of the current release plus features like artist browsing, text searching, and so on.

Can you add plugin x?

There are hundreds of music streaming services out there, so I'll mainly focus on the two plugins listed below.

Can you remove the "Respect the artists! Pay for music when you can! Downloaded with Athame" tag?

No. The purpose of that tag is to remind people that Athame is a tool for saving music from streaming services for personal use only, and not a tool for illegal distribution of music.

Plugins

These are included by default

A plugin written by TripleFrequency, which works great and is available to download here.

Spotify

Currently, I have no plans to work on a Spotify plugin. A similar thing called librespot exists, so maybe one day this could be ported to C#.

Apple Music

As far as I know, nobody has documented the Apple Music API yet, so nope.

Qobuz

Qobuz isn't available in my country at the moment, so I have no plans to implement it.

At the moment, I am mostly working on the Athame core application, so I can't spend my time writing plugins for other services.

Plugins are always distributed as Zip files - to install a plugin, simply extract the zip to the "Plugins" folder, which is in the same directory as the Athame executable. A guide for creating your own plugins can be found on the wiki.

Then...

Open the Athame.exe executable.

Keeping up to date

Follow me on Twitter @svbnet and subscribe to my blog to stay up to date.

Usage

Enter a URL in the "URL" textbox, then click "Add". It will show up in the download queue. Click "Start" to begin downloading.

If you haven't signed in, you can click the Menu button, then go to Settings and choose the tab of the music service you want to sign into. You can also just enter a URL and click "Click here to sign in" on the error message below the URL textbox.

Under Settings > General, you can change where music is downloaded to as well as the filename format used. There is an explanation of the valid format specifiers on the General tab.

Build

  • .NET 4.6.2 or later
  • Visual Studio 2015 (Express will work fine) or later with NuGet

Roadmap

While Athame currently uses WinForms for its UI, this is a halfway solution to an ideal UI. I'm currently in the process of creating a WPF UI to replace the WinForms UI, which will hopefully also fix many bugs in the process. I am also currently considering a cross-platform interface (since WinForms is incredibly buggy on non-Windows platforms), but again this is just a consideration as writing a command-line interface would take time away from porting it to WPF. A GTK# interface would also be possible, but would take a while since I am unfamiliar with GTK#. There are currently no plans for a Cocoa (OS X) interface since I do not have a Mac.

athame's People

Contributors

svbnet avatar mones88 avatar

Forkers

mountaser

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.