v 1.0

Author: ApplePie420

.gitignore

@@ -0,0 +1,68 @@
+# Cue sheet generator
+You like your songs organised, and when listening to sets, you want to just look at foobar2000 (you don't use anything else, be honest ;) and know, what song is playing. For that, there is certain type of file called _cuesheet_. This file contains info about track artist, title and its timestamp in the mix. I love these files, it's really convinient on PC and mobile. But manually creating these files, or using some online generators is major pain in the butt. And since you already have (presumably) tracklist with timestamps, why not create a tool that generates this file for you?
+
+# Usage
+## Installation
+You don't need any special packages. Only two imports that I use are _os_ package for manipulating with files, and my custom [cue file generator](cuefilegenerator.py). So just clone the repo:
+```bash
+git clone https://github.com/ApplePie420/CueSheetGenerator.git
+```
+
+and then run
+
+```bash
+python generator.py
+```
+
+and just follow instructions.
+
+## Using the script
+First of all, insert __name of performer__, i.e. the person that mixed the set.
+
+Then, it'll ask you for path where __your audio file and tracklist.txt is__. Enter full path, for example
+```
+D:\music\sets\myFavouriteProducer\myFavouriteMix\
+```
+or on linux
+```
+/home/yourName/music/myFavouriteProducer/myFavouriteMix/
+```
+You __do not need__ to insert the path between quotation marks, even if it contains spaces. It works somehow. If it doesn't, then try it with them :D
+
+__Script automatically looks for audio files__ with these extensions:
+- mp3
+- m4a
+- ogg/opus
+- aac
+- flac
+- wav
+- wma
+- aiff
+- alac
+Although for now, it only works with __mp3, m4a, ogg/opus, flac and alac__.
+
+Next, you need to specify your __tracklist__ file. By default, it will look for file named `tracklist.txt`. If your tracklist is named differently, for example `list.txt`, type that in. __!Be sure that tracklist is formatted as needed (example below)!__.
+
+And if everything went well, a _.cue_ file should append in your directory.
+
+# Tracklist format
+Obviously, this script is not magical and it cannot read your tracklist properly unless it is formatted properly. So your tracklist should look like this:
+```
+00:00:00 Artist - Title
+00:05:30 Artist - Title
+00:12:58 Artist - Title
+...
+01:03:34 Artist - Title
+```
+
+You __HAVE__ to have a space between timestamp and song name, and a ` - ` (aka space dash space) between artist and title. 
+Time is formatted in HH:MM:SS, where HH is hours, MM are minutes and SS seconds. Script automatically transforms hours into minutes, and adds CD frame (defaults to 00). And yes, there __HAS__ to be leading zeroes. 1. It makes it look pretty and 2. I've hardcoded timestamp length.. :D (I will change it later)
+
+I may add different tracklist formats support later, but honestly why. This is very readable, compact and have all necessary information. And __YES, you can have `[label]` at the end__. If you have problem with this tracklist format, either get used to it, fork this script and modify it, or create other script to convert your format to mine. 
+
+# Todo list
+[] - Automatically detect codec for cue `FILE` parameter
+[] - Ignore missing leading zeroes
+[] - Add `REM GENRE` and `DATE`
+
+If you have Issues, you know where to post them. Please, feel free to fork, upgrade and request merge. I made this in under an hour so it won't be perfect.

README.md

@@ -0,0 +1,49 @@
+import os
+
+def write_cue_file(performer, title, file, tracks, tracks_timestamp, savePath):
+    f = open(savePath + title + ".cue", "w")
+    # check if all of data is present
+    if(performer == ""):
+        print("Performer not specified!")
+        return 1
+    elif(title == ""):
+        print("Title not specified!")
+        return 1
+    elif(file == ""):
+        print("File path not specified!")
+        return 1
+    elif(len(tracks) != len(tracks_timestamp)):
+        print("Tracks and timestamps count does not match")
+        return 1
+    else:
+        # try to guess codec, this might not work always
+        # TODO: make this somehow automated, maybe some packages?
+        extension = file.split(".")[1]
+        codec = ""
+        if(extension == "mp3"):
+            codec = "MP3"
+        elif(extension == "m4a"):
+            codec = "AAC"
+        elif(extension == "ogg" or extension == "opus"):
+            codec = "AIFF"
+        elif(extension == "flac"):
+            codec = "FLAC"
+        elif(extension == "alac"):
+            codec = "ALAC"
+        # write info about cuesheet
+        f.write("PERFORMER \"" + performer + "\"\n")
+        f.write("TITLE \"" + title + "\"\n")
+        f.write("FILE \"" + file + "\" " + str(codec) + "\n")
+
+        # write individual tracks
+        for i in range(len(tracks)):
+            # TRACK 0x AUDIO
+            f.write("\tTRACK %02d AUDIO\n" % (i+1,))
+            # PERFORMER "DJ_name"
+            f.write("\t\tPERFORMER \"" + tracks[i].split(" - ")[0] + "\"\n")
+            # TITLE "title"
+            f.write("\t\tTITLE \"" + tracks[i].split(" - ")[1] + "\"\n")
+            # INDEX 01 timestamp
+            f.write("\t\tINDEX 01 " + tracks_timestamp[i] + ":00\n")
+        f.close()
+        return 0

cuefilegenerator.py

@@ -0,0 +1,72 @@
+import os
+from cuefilegenerator import write_cue_file
+
+def get_audio_files(folder):
+    audio_ext = [".mp3", ".m4a", ".ogg", ".opus", ".aac", ".flac", ".wav", ".wma", ".aiff", ".alac"]
+    for file in os.listdir(folder):
+        if file.endswith(tuple(audio_ext)):
+            return file
+
+def get_timestamps(tracklist):
+    # open file
+    f = open(tracklist, "r")
+    # read lines and split by \n
+    content = f.read()
+    content = content.split("\n")
+
+    # array to return
+    tStamps = []
+
+    # get all timestamps
+    for song in content:
+        timestamps = song.split(" ")[0]
+
+        #get individually hours, minutes and seconds
+        hours =  timestamps.split(":")[0]
+        minutes = timestamps.split(":")[1]
+        seconds = timestamps.split(":")[2]
+
+        # parse hours into minutes
+        if(int(hours) > 0):
+            minutes = int(minutes) + int(hours)*60
+
+        # create cuefile timestamp in format MM:SS where MM is minutes, SS seconds
+        timestamp = str(minutes) + ":" + str(seconds)
+        tStamps.append(timestamp)
+    return tStamps
+
+def get_songs(tracklist):
+    # open file
+    f = open(tracklist, "r")
+    # read lines and split by \n
+    content = f.read()
+    content = content.split("\n")
+
+    # array to return
+    songs = []
+
+    for song in content:
+        track = song[9:]
+        songs.append(track)
+
+    return songs
+
+####################################### main program #####################################
+performer = input("Performer: ")
+path = input("Enter DIRECTORY path where audio file and tracklist is (default './'): ")
+if(path == ""):
+    path = "./"
+file = get_audio_files(path)
+title = file.split(".")[0]
+
+tracklist = input("Tracklist file (default 'tracklist.txt'): ")
+# make "tracklist.txt" default tracklist
+if(tracklist == ""):
+    tracklist = path + "tracklist.txt"
+
+# get timestamps and song names and artists
+timestamps = get_timestamps(tracklist)
+songs = get_songs(tracklist)
+
+# write to a cuesheet
+write_cue_file(performer, title, file, songs, timestamps, path)