{"id":26763854,"url":"https://github.com/cwefso/catchy","last_synced_at":"2025-03-28T19:35:11.310Z","repository":{"id":275227858,"uuid":"925472301","full_name":"cwefso/catchy","owner":"cwefso","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-20T00:13:08.000Z","size":399,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-20T01:23:46.253Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://the-hook-ruddy.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cwefso.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-01T00:23:06.000Z","updated_at":"2025-03-20T00:13:12.000Z","dependencies_parsed_at":"2025-02-01T01:25:15.393Z","dependency_job_id":"c87c0063-a593-4599-a93c-9be2af80cc47","html_url":"https://github.com/cwefso/catchy","commit_stats":null,"previous_names":["cwefso/the-hook","cwefso/catchy"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cwefso%2Fcatchy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cwefso%2Fcatchy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cwefso%2Fcatchy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cwefso%2Fcatchy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cwefso","download_url":"https://codeload.github.com/cwefso/catchy/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246089098,"owners_count":20721818,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-28T19:35:09.757Z","updated_at":"2025-03-28T19:35:11.304Z","avatar_url":"https://github.com/cwefso.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Music Recognition App\n\nThis is a music recognition app that uses the Shazam API for song detection and Spotify for playlist integration. To get started, you'll need to set up the required environment variables.\n\n---\n\n## Prerequisites\n\nBefore running the app, ensure you have the following:\n\n1. **Node.js** installed (v16 or higher recommended).\n2. **npm** or **yarn** installed.\n3. A **Spotify Developer Account** to obtain `NEXT_PUBLIC_SPOTIFY_CLIENT_ID` and `NEXT_PUBLIC_SPOTIFY_CLIENT_SECRET`.\n4. A **RapidAPI Account** to obtain `NEXT_PUBLIC_RAPIDAPI_KEY`.\n\n---\n\n## Setting Up Environment Variables\n\nTo run this app, you need to set up the following environment variables:\n\n| Variable Name                       | Description                                                      |\n| ----------------------------------- | ---------------------------------------------------------------- |\n| `NEXT_PUBLIC_SPOTIFY_CLIENT_ID`     | Your Spotify App's Client ID.                                    |\n| `NEXT_PUBLIC_SPOTIFY_CLIENT_SECRET` | Your Spotify App's Client Secret.                                |\n| `NEXT_PUBLIC_SPOTIFY_REDIRECT_URI`  | The redirect URI configured in your Spotify Developer Dashboard. |\n| `NEXT_PUBLIC_RAPIDAPI_KEY`          | Your RapidAPI key for accessing the Shazam API.                  |\n\n### Step 1: Obtain Spotify Credentials\n\n1. Go to the [Spotify Developer Dashboard](https://developer.spotify.com/dashboard/applications).\n2. Log in or create a new account if you don’t have one.\n3. Click **Create an App** and fill in the required details.\n4. Once the app is created, you’ll see the **Client ID** and **Client Secret** on the app’s dashboard.\n5. Set the **Redirect URI** to `http://localhost:3000/callback/spotify/` in the app settings.\n\n### Step 2: Obtain RapidAPI Key\n\n1. Go to the [Shazam API on RapidAPI](https://rapidapi.com/apidojo/api/shazam/).\n2. Sign up or log in to your RapidAPI account.\n3. Subscribe to the Shazam API (free tier available).\n4. After subscribing, you’ll find your API key (`X-RapidAPI-Key`) in the **Code Snippets** section.\n\n### Step 3: Set Up Environment Variables\n\nCreate a `.env.local` file in the root of your project and add the following variables:\n\n# Music Recognition App\n\nThis is a music recognition app that uses the Shazam API for song detection and Spotify for playlist integration. To get started, you'll need to set up the required environment variables.\n\n---\n\n## Prerequisites\n\nBefore running the app, ensure you have the following:\n\n1. **Node.js** installed (v16 or higher recommended).\n2. **npm** or **yarn** installed.\n3. A **Spotify Developer Account** to obtain `NEXT_PUBLIC_SPOTIFY_CLIENT_ID` and `NEXT_PUBLIC_SPOTIFY_CLIENT_SECRET`.\n4. A **RapidAPI Account** to obtain `NEXT_PUBLIC_RAPIDAPI_KEY`.\n\n---\n\n## Setting Up Environment Variables\n\nTo run this app, you need to set up the following environment variables:\n\n| Variable Name                       | Description                                                      |\n| ----------------------------------- | ---------------------------------------------------------------- |\n| `NEXT_PUBLIC_SPOTIFY_CLIENT_ID`     | Your Spotify App's Client ID.                                    |\n| `NEXT_PUBLIC_SPOTIFY_CLIENT_SECRET` | Your Spotify App's Client Secret.                                |\n| `NEXT_PUBLIC_SPOTIFY_REDIRECT_URI`  | The redirect URI configured in your Spotify Developer Dashboard. |\n| `NEXT_PUBLIC_RAPIDAPI_KEY`          | Your RapidAPI key for accessing the Shazam API.                  |\n\n### Step 1: Obtain Spotify Credentials\n\n1. Go to the [Spotify Developer Dashboard](https://developer.spotify.com/dashboard/applications).\n2. Log in or create a new account if you don’t have one.\n3. Click **Create an App** and fill in the required details.\n4. Once the app is created, you’ll see the **Client ID** and **Client Secret** on the app’s dashboard.\n5. Set the **Redirect URI** to `http://localhost:3000/callback/spotify/` in the app settings.\n\n### Step 2: Obtain RapidAPI Key\n\n1. Go to the [Shazam API on RapidAPI](https://rapidapi.com/apidojo/api/shazam/).\n2. Sign up or log in to your RapidAPI account.\n3. Subscribe to the Shazam API (free tier available).\n4. After subscribing, you’ll find your API key (`X-RapidAPI-Key`) in the **Code Snippets** section.\n\n### Step 3: Set Up Environment Variables\n\nCreate a `.env.local` file in the root of your project and add the following variables:\n\n```env\nNEXT_PUBLIC_SPOTIFY_CLIENT_ID\nNEXT_PUBLIC_SPOTIFY_CLIENT_SECRET\nNEXT_PUBLIC_SPOTIFY_REDIRECT_URI\nNEXT_PUBLIC_RAPIDAPI_KEY\n```\n\n---\n\n## Running the App\n\n1. 1. Install dependencies:\n\n```bash\nnpm install\n# or\nyarn install\n```\n\n2. Start the development server:\n\n```bash\nnpm run dev\n# or\nyarn dev\n```\n\n3. Open your browser and navigate to `http://localhost:3000`.\n\n---\n\n## Best Practices for Environment Variables\n\n- **Never commit `.env.local` to version control:** Add `.env.local` to your `.gitignore` file to avoid exposing sensitive credentials.\n- **Use environment variables in production:** For production deployments, configure environment variables directly in your hosting provider (e.g., Vercel, Netlify, AWS).\n- **Rotate credentials regularly:** If you suspect your credentials are compromised, regenerate them in the respective developer dashboards.\n\n---\n\n## Troubleshooting\n\n- **Invalid Spotify Redirect URI:** Ensure the redirect URI in your `.env.local` file matches exactly with the one configured in the Spotify Developer Dashboard.\n- **RapidAPI Key Not Working:** Verify that your RapidAPI subscription is active and the key is correctly copied.\n- **Environment Variables Not Loaded:** Restart your development server after adding or modifying environment variables.\n\n---\n\n## Contributing\n\nIf you’d like to contribute to this project, please follow these steps:\n\n1. Fork the repository.\n2. Create a new branch for your feature or bugfix.\n3. Submit a pull request with a detailed description of your changes.\n\n---\n\n## License\n\nThis project is licensed under the MIT License. See the LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcwefso%2Fcatchy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcwefso%2Fcatchy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcwefso%2Fcatchy/lists"}