{"id":15601646,"url":"https://github.com/pranshu05/tunestats","last_synced_at":"2026-02-27T04:31:34.830Z","repository":{"id":169647622,"uuid":"639247864","full_name":"pranshu05/tunestats","owner":"pranshu05","description":"Your Spotify stats, re-imagined — rate, share, and connect with friends.","archived":false,"fork":false,"pushed_at":"2025-12-06T06:52:27.000Z","size":18952,"stargazers_count":10,"open_issues_count":5,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-12-09T23:50:27.583Z","etag":null,"topics":["analytics","authentication","charts","comments","comments-system","friends","nextjs","postgresql","profile-page","ratings","ratings-app","social-network","spotify","spotify-api","tailwindcss","typescript"],"latest_commit_sha":null,"homepage":"https://tunestats.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pranshu05.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-05-11T04:36:32.000Z","updated_at":"2025-12-06T06:52:31.000Z","dependencies_parsed_at":"2024-04-08T21:10:05.073Z","dependency_job_id":"2840556c-2f9d-470a-92c7-81b988bc14b6","html_url":"https://github.com/pranshu05/tunestats","commit_stats":null,"previous_names":["pranshu05/spotify-activity","pranshu05/protify","pranshu05/tunestats"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pranshu05/tunestats","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranshu05%2Ftunestats","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranshu05%2Ftunestats/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranshu05%2Ftunestats/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranshu05%2Ftunestats/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pranshu05","download_url":"https://codeload.github.com/pranshu05/tunestats/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranshu05%2Ftunestats/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29884691,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-26T23:51:21.483Z","status":"online","status_checked_at":"2026-02-27T02:00:06.759Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["analytics","authentication","charts","comments","comments-system","friends","nextjs","postgresql","profile-page","ratings","ratings-app","social-network","spotify","spotify-api","tailwindcss","typescript"],"created_at":"2024-10-03T02:23:47.398Z","updated_at":"2026-02-27T04:31:34.813Z","avatar_url":"https://github.com/pranshu05.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TuneStats 🎵\n\n**TuneStats** is a web application that allows users to track their Spotify stats, share their profiles, and compare their music taste with friends.\n\n## 🚀 Features\n\n- **Spotify Authentication**: Securely log in with your Spotify account.\n- **Sharable User Profiles**: Generate personalized, shareable profiles for showcasing your Spotify activity.\n- **Comments Section**: Engage with the community by leaving comments on profiles, tracks/albums/artist pages.\n- **Rating System**: Rate your favorite tracks, albums, and artists just like IMDb but for Spotify!.\n- **Add Friends**: Build a network of friends and explore their music preferences.\n- **Friend Comparable Charts**: Compare your Spotify stats with friends in personalized charts.\n- **Privacy Control**: Set your profile as public or private based on your preference.\n- **Responsive Design**: Enjoy a seamless experience across all devices.\n- **Artist Page**: View detailed information about your favorite artists.\n- **Track Page**: Explore detailed insights about your top tracks.\n- **Album Page**: Discover more about your favorite albums.\n- **Global Stats**: View global stats of all top tracks, albums, and artists.\n- **Personalized Album Chart**: Get a personalized album chart based on your Spotify listening history.\n\n---\n\n## 🛠️ Getting Started\n\nFollow these steps to set up TuneStats on your local machine:\n\n### Prerequisites\n\nMake sure you have the following installed:\n- Node.js (v16 or later)\n- npm or yarn\n- Spotify Developer account to set up API credentials\n\n### Installation\n\n1. **Fork the Repository**\n   Click the `Fork` button on the top right of this repository to create your copy.\n\n2. **Clone the Repository**\n   Clone your forked repo to your local machine:\n   ```bash\n   git clone https://github.com/pranshu05/tunestats.git\n   cd tunestats\n   ```\n\n3. **Install Dependencies**\n   Install the required packages using npm or yarn:\n   ```bash\n   npm install\n   ```\n   or\n   ```bash\n   yarn install\n   ```\n\n4. **Set Up Environment Variables**\n   Create a `.env` file in the root directory and configure the following environment variables:\n   ```env\n   SPOTIFY_CLIENT_ID=`your_spotify_client_id`\n   SPOTIFY_CLIENT_SECRET=`your_spotify_client_secret`\n   NEXTAUTH_SECRET=`your_nextauth_secret`\n   NEXTAUTH_URL=`http://localhost:3000`\n   DATABASE_URL=`your_database_url`(neon db)\n   ```\n\n5. **Setup Database**\n   - Create a Neon database and set up the connection string in your `.env` file.\n   - Run the DDL scripts from [DDL Script File](/db/create_tables.sql) to create the necessary tables in your database.\n\n6. **Run the Development Server**\n   Start the development server:\n   ```bash\n   npm run dev\n   ```\n   or\n   ```bash\n   yarn dev\n   ```\n\n7. **Open in Browser**\n   Open http://localhost:3000 to view the app.\n\n---\n\n## 🤝 Contribution Guidelines\n\nWe welcome contributions! Follow these steps to contribute:\n\n1. **Fork the Repository**\n   Click the `Fork` button on the top right of this repository to create your copy.\n\n2. **Create a Feature Branch**\n   ```bash\n   git checkout -b feature/\u003cfeature-name\u003e\n   ```\n\n3. **Make Your Changes**\n   Add your changes and commit:\n   ```bash\n   git add .\n   git commit -m \"Add \u003cfeature-name\u003e\"\n   ```\n\n4. **Push Your Changes**\n   ```bash\n   git push origin feature/\u003cfeature-name\u003e\n   ```\n\n5. **Open a Pull Request**\n   Go to the original repository and open a pull request describing your changes.\n\n---\n\n## 📝 License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n---\n\n### 🌟 Support\n\nIf you like this project, please give it a star ⭐ and share it with your friends!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpranshu05%2Ftunestats","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpranshu05%2Ftunestats","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpranshu05%2Ftunestats/lists"}