qzdl · qzdl · Sep 28, 2019 · Sep 30, 2019 · Sep 30, 2019 · Oct 3, 2019
diff --git a/.gitignore b/.gitignore
@@ -131,4 +131,6 @@ config*
 .\#*
 
 # venv
+*secret*
+client.json
 # samplify/
diff --git a/README.md → README.org b/README.md → README.org
@@ -1,8 +1,7 @@
-# Samplify
+* Samplify
 Retrieve the samples from any playlist / album / song / search.
 
-## Getting Started
-Setup TLDR; 
+Setup TLDR;
 ```
 git clone https://github.com/qzdl/samplify.git && cd samplify && venv samplify && source samplify/bin/activate && pip -r requirements.txt
 ```
@@ -20,8 +19,8 @@ If you haven't used the spotify API before:
 - Setup a redirect as `http://localhost:<SOME_FREE_PORT>`
   * This can be found in the information page of a registered application > edit settings.
 - Create `config.py` at the root of the repository, and populate it as follows:
-(NOTE: these are not valid credentials )
-```
+(NOTE: these are not valid credentials)
+#+BEGIN-SRC
 # ClientID from registered application at:
 https://developers.spotify.com/dashboard/applications
 client = '7bf224e8jn954215s3g11degh599e3an'
@@ -38,13 +37,16 @@ username = '1134745600'
 # setup this redirect on a registered application. make sure it
 # is identical to the letter or you'll get "INVALID REDIRECT"
 redirect = 'http://localhost:8889'
-```
+#+END-SRC
+
+** Usage
+
+[[file:docs/spotify_cap.png][train of thought, generated by samplify]]
 
-## Usage
 ![Playlists created by the tool](./docs/spotify_cap.png)
 
-## Documentation
-### Command Line Interface `CLI`
+** Documentation
+*** Command Line Interface `CLI`
 Detail about the CLI can be found by reading the documentation provided by the `--help`
 option flag. Documentation will but updated there as the project progresses.
 ```
@@ -123,22 +125,21 @@ It's a New Day skull snaps
 Created playlist SAMPLIFY: Uptown Saturday Night
 ```
 
+** Program Overview
+Playlists are read from Spotify through the Spotify API using Spotipy.
+Song names and artists are stored and then located on `Whosampled.com`.
 
-## Program Overview
-Playlists are read from Spotify through the Spotify API using Spotipy.  
-Song names and artists are stored and then located on `Whosampled.com`.  
-
-A request is sent to the site searching for the song name, selecting a result  
-with the matching artist name and storing the link to that song's page. A second  
-request is sent to that song page, and BeautifulSoup is used to scrape HTML for  
+A request is sent to the site searching for the song name, selecting a result
+with the matching artist name and storing the link to that song's page. A second
+request is sent to that song page, and BeautifulSoup is used to scrape HTML for
 sample names, which are also stored.
 
-Next, the samples are located using Spotipy, if they exist. Finally, a new  
+Next, the samples are located using Spotipy, if they exist. Finally, a new
 playlist is created for the user, containing all the samples available on Spotify.
 
 ## Example Route Parsing
-Discovering how payloads differ to extend the functionality to albums, current song,  
-etc, is a process that requires some exploration. I'm sure there's examples of that  
+Discovering how payloads differ to extend the functionality to albums, current song,
+etc, is a process that requires some exploration. I'm sure there's examples of that
 in the commit history.
 ```python
 album = None
@@ -160,10 +161,10 @@ for track in tracks:
 print(json.dumps(track_info, indent=2))
 ```
 
-## Attribution
+** Attribution
 This project is based on the work of [Christopher Pease (cpease00)](https://github.com/cpease00/)'s sample collection tool   [Spotify-Samples](https://github.com/cpease00/).
 Without his [medium article](https://medium.com/@chris.m.pease/automating-finding-music-samples-on-spotify-with-whosampled-54f86bcda1ee) on the topic, it would have been much more painful to produce the project as it is now.
 
-### `Options()`
-### `Samplify()`
-### `Scraper()`
+*** `Options()`
+*** `Samplify()`
+*** `Scraper()`
diff --git a/examples/album_93-til-infinity_souls-of-mischief b/examples/album_93-til-infinity_souls-of-mischief
diff --git a/examples/album_body-of-the-life-force_afu-ra b/examples/album_body-of-the-life-force_afu-ra
diff --git a/examples/album_dead-serious_das-efx b/examples/album_dead-serious_das-efx
diff --git a/examples/album_dogg-food_the-dogg-pound b/examples/album_dogg-food_the-dogg-pound
diff --git a/examples/album_even-in-darkness_dungeon-family b/examples/album_even-in-darkness_dungeon-family
diff --git a/examples/album_moment-of-truth_gang-starr b/examples/album_moment-of-truth_gang-starr
diff --git a/examples/album_resurrection_common b/examples/album_resurrection_common
diff --git a/examples/album_the-lp_large-professor b/examples/album_the-lp_large-professor
diff --git a/examples/album_train-of-thought_reflection-eternal b/examples/album_train-of-thought_reflection-eternal
diff --git a/examples/album_uptown-saturday-night_camp-lo b/examples/album_uptown-saturday-night_camp-lo
diff --git a/notebooks/__init__.py b/notebooks/__init__.py
@@ -0,0 +1,2 @@
+import sys
+sys.path.append('../')
diff --git a/notebooks/youtube-api.ipynb b/notebooks/youtube-api.ipynb