2 files changed, 65 insertions(+), 0 deletions(-)

A LICENSE.md
A README.md

@@ 0,0 1,31 @@
+BSD 3-Clause License
+====================
+
+_Copyright (c) 2024, Dominic Ricottone_  
+_All rights reserved._
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

@@ 0,0 1,34 @@
+# nspotify
+
+Minimal TUI spotify client.
+Read-only interface to a user's saved songs.
+Playback sold separately,
+see [spotifyd](https://github.com/Spotifyd/spotifyd) or
+[go-librespot](https://github.com/devgianlu/go-librespot).
+
+
+## Building
+
+Depends on a small set of libraries:
+
+ + [zmb3's spotify API wrapper](github.com/zmb3/spotify)
+ + [logrus](github.com/sirupsen/logrus) for logging
+ + [tview](github.com/rivo/tview) and [tcell](https://github.com/gdamore/tcell)
+   for the TUI
+ + external `oauth2` package
+
+A Spotify API client ID and secret are required.
+See [here](https://github.com/zmb3/spotify?tab=readme-ov-file#authentication)
+for more details.
+Then try:
+
+```
+go build -ldflags "-X main.CLIENTID=yourclientid -X main.CLIENTSECRET=yourclientsecret" .
+```
+
+
+## Licensing
+
+I share the contents of this repository under the BSD 3 clause license.
+
+