junnishimura / chatify

Chat-based music recommendation tool

♫ Chatify ♫
chat-based music recommendation tool

📖 Overview

Chatify is a TUI(Terminal User Interface) tool that combines the OpenAI API with the Spotify API, allowing an AI bot to recommend the music you are looking for through conversation.

1. You can find the music you are looking for by answering questions.
2. You can listen to the music by selecting the track recommended by chatify.
3. You can store results of recommendations as playlists.

⚠️ Notice

Unfortunately, Chatify is currently not free to use; you need to have a Spotify Premium account and pay to use the OpenAI API.

👜 Prerequisites

Chatify requires two things.

1. You need to have a Spotify Premium Account to use Spotify API.
2. You need to have a OpenAI account to use OpenAI API.

💻 How to use

It is recommended that the terminal is set to full-screen size when to use Chatify.

1. Install

Homebrew Tap

brew install JunNishimura/tap/Chatify

Go install

go install github.com/JunNishimura/Chatify@latest

2. Preparation

Before saying hi to Chatify, please prepare the following three items.

1. Spotify App Client ID
2. Spotify App Client Secret
3. OpenAI API key

Spotify API

Please create any app from the Spotify for Developers Dashboard and retrieve the Client ID and Secret from the settings screen.

OpenAI API

Please create an API key from the OpenAI account screen and obtain it.

3. Greetings to Chatify

You need to provide a couple of information to Chatify at first.

$ chatify greeting

4. Talk with Chatify

Let's talk to Chatify and embark on a journey to discover new music!

$ chatify hey

⌨️ Operation

Key	Action
tab	switch the view
characters	input words
q, ctrl+c	quit
enter	answer, select
↑, ↓	move in list
←, →	turn page

🔨 Options

greeting command

-p, --port

Flag to specify the port number for Spotify authorization. Default number is 8888.

hey command

-n, --number

Flag to specify the number of recommendations. Default number is 25 and maximum number is 100.

-p, --playlist

Flag to enable chatify to make playlist based on the recommendation. Default is false.

🪧 License

Chatify is released under MIT License. See MIT

chatify's Issues

update chat view

show spinner until bot generates messages

replace prompt text with code

handle with window resizing

refactoring UI

unify overlapping codes

get an access token by using refresh token

show error window when to press item without opening spotify

add README

improve authorize finish process

• add spinner when writing config to file
• show what to do after greeting

install bubbletea

install cobra package

add playlist flag to make playlist for hey command

add github actions

refactor UI

get device id

bug on hey command

clean up ui package

adjust window size

add num flag to control recommendation num for hey command

get key from the command line

add Spotify library

change ui directory

add OpenAI library

update recommendation list view

add unit tests

make auth package and authorize in greeting cmd

change package name: util -> utils

integrate multiple elments to recommend music

update chat view

simple artist recommendation

add more questions to tune recommendation

control list view while it's not focused

update view for hey command

enable listening music

update greeting UI

recommend music by using Spotify recommend API

change the way of user reply

change spotify package

change text input color

update behaviour when the error happens

recommend music by using open ai api

limit the length of track name

add port flag to control port num for greeting command

add greeting command

refactor greeting UI

change directory architecture

refactor UI around base

update recommendation list view

env -> config

add docs to each command

add Viper