search

mikrasilnikov / vine

MIT License
0 stars 0 forks source link

readme

Ниже есть перевод на русский.

Vine

Vine is a tool for DJs and electronic music lovers that allows them to quickly listen to previews of new tracks in popular online music stores (Beatport and Traxsource). The program saves time by downloading previews and allows user to employ his/her favorite media player.

If you are happy with your favorite streaming service and wondering why anyone would want to listen to any previews nowadays, then you are a normal person and vine is not for you.

What's the problem?

There are many.

All of this makes many DJs rely on charts and selections considerably limiting their choice.

How Vine solves these problems?

Ok. How to try the thing?

alt text

But I don't listen to house!

The --genres parameter allows to specify one or more values separated by a comma. Here is an example for downloading previews for all supported genres:

java -jar vine.jar --genres=house,tech,funky,nudisco,soulful,soulfunk,deep,progressive,melodic,afro,techno,lounge,minimal,dnb

But I want previews for another date!

The --date parameter is used to specify a date range. You can set either a specific date

  java -jar vine.jar --genres=house --date=2021-06-01

or a period

  java -jar vine.jar --genres=house --date=2021-06-01,2021-06-07

Range boundaries are inclusive. In the example above vine would download previews for the 1st and 7th of June. Unfortunately, at the moment, Beatport has a problem with showing results for large periods. See the section below.

Do I have to type it all by hand every time?

No. The archive with the program contains the files run.bat andrun.sh for different operating systems. You can specify the desired genres in them and simply change the date before every run.

my genre

Vine has a feature similar to the My Traxsource and My Beatport sections. You can create a list of artists and labels whose releases will be downloaded to the previews/{date}/01-my-traxsource andpreviews/{date}/01-my-beatport folders. By default, lists are being read from data\MyArtists.txt and data\MyLabels.txt. To download your personal selection add my to the list of genres:

java -jar vine.jar --genres=my,house

Labels blacklist

Releases from labels listed in data\ShitLabels.txt will be ignored. However, tracks in charts (top 100 or featured) will still be downloaded.

Personal configuration

Instead of the --genres parameter, you can specify a path to a configuration file.

java -jar vine.jar --config=config.json --date=2021-06-01

In this file, you can specify sources for downloading previews and set additional parameters. The sample configuration file with the name config.sample.json is included.

Limitations for Date Ranges

Vine

Vine - это инструмент для DJ и любителей электронной музыки, который позволяет быстро отслушивать превью новых треков из популярных музыкальных магазинов (Beatport и Traxsource). Программа экономит время, скачивая превью, и дает возможность использовать свой плеер для прослушивания.

Если вы вполне довольны вашим стриминговым сервисом и не понимаете, зачем вообще нужно в наши дни слушать какие-то превью в каких-то музыкальных магазинах, то вы нормальный человек и это все не для вас.

В чем проблема?

Их много.

Все это заставляет многих DJ-ев полагаться на чарты и подборки, что существенно ограничивает их выбор.

Как Vine решает эти проблемы?

Окей, как это попробовать?

Но я не слушаю house!

Параметр --genres позволяет указать один или несколько стилей через запятую. Вот пример команды для скачивания превью всех поддерживаемых стилей:

java -jar vine.jar --genres=house,tech,funky,nudisco,soulful,soulfunk,deep,progressive,melodic,afro,techno,lounge,minimal,dnb

Но я хочу за другую дату!

Для указания периода используется параметр --date. Можно выбирать как конкретную дату

  java -jar vine.jar --genres=house --date=2021-06-01

так и диапазон

  java -jar vine.jar --genres=house --date=2021-06-01,2021-06-07

Границы диапазонов указываются включительно. В примере выше превью будут скачиваться и за 1-е, и за 7-е июня. К сожалению, на данный момент, у Beatport-а есть проблема с выдачей результатов за большие диапазоны. См. раздел о диапазонах дат.

Каждый раз надо это все печатать руками?

Это не обязательно. В архиве с программой есть файлы run.bat и run.sh для разных операционных систем. Можно указать в них нужные стили и просто менять дату перед запуском.

Стиль my

Vine имеет функцию, аналогичную разделам My Traxsource и My Beatport. Можно создать список исполнителей и лейблов, релизы которых будут скачиваться в папки previews/{date}/01-my-traxsource и previews/{date}/01-my-beatport. По умолчанию списки находятся в файлах data\MyArtists.txt и data\MyLabels.txt. Чтобы скачать свою персональную подборку, нужно добавить my к списку стилей:

java -jar vine.jar --genres=my,house

Черный список лейблов

Релизы лейблов, перечисленных в файле data\ShitLabels.txt будут игнорироваться. Однако треки, которые попали в чарты (топ-100 или featured), все равно будут скачаны.

Персональная конфигурация

Вместо параметра --genres можно указать путь к своему файлу конфигурации.

java -jar vine.jar --config=config.json --date=2021-06-01

В этом файле можно перечислить разделы для скачивания превью и установить дополнительные настройки. Пример файла конфигурации называется config.sample.json.

Ограничения для диапазонов дат

alt text

а в файле vine.log появятся записи

  Got empty last page of 01-my-beatport. Beatport 10K bug?
  Empty intermediate page (Beatport 10K bug?): Right(https://www.beatport.com/tracks/all?per-page=150&start-date=2021-01-01&end-date=2021-01-08&page=67)

Поддержка признает наличие проблемы и говорит, что они вовсю работают над этим.