{"id":17711781,"url":"https://github.com/quentingenet/vinylkeeper","last_synced_at":"2026-01-22T05:34:16.579Z","repository":{"id":251473046,"uuid":"837511913","full_name":"quentingenet/vinylkeeper","owner":"quentingenet","description":"When music and code spin together, cool happens.","archived":false,"fork":false,"pushed_at":"2026-01-13T07:21:54.000Z","size":9258,"stargazers_count":4,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-13T10:32:19.821Z","etag":null,"topics":["alembic","fastapi","material-ui","postgresql","pydantic","python","react","sqlalchemy","typescript"],"latest_commit_sha":null,"homepage":"https://vinylkeeper.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/quentingenet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-08-03T07:35:25.000Z","updated_at":"2026-01-13T07:21:58.000Z","dependencies_parsed_at":"2024-08-11T12:47:44.604Z","dependency_job_id":"6a7517f8-e0f0-43ea-b7ea-b08785b7c453","html_url":"https://github.com/quentingenet/vinylkeeper","commit_stats":null,"previous_names":["quentingenet/vinylkeeper"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/quentingenet/vinylkeeper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quentingenet%2Fvinylkeeper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quentingenet%2Fvinylkeeper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quentingenet%2Fvinylkeeper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quentingenet%2Fvinylkeeper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/quentingenet","download_url":"https://codeload.github.com/quentingenet/vinylkeeper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quentingenet%2Fvinylkeeper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28656304,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-22T01:17:37.254Z","status":"online","status_checked_at":"2026-01-22T02:00:07.137Z","response_time":144,"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":["alembic","fastapi","material-ui","postgresql","pydantic","python","react","sqlalchemy","typescript"],"created_at":"2024-10-25T08:07:57.657Z","updated_at":"2026-01-22T05:34:16.574Z","avatar_url":"https://github.com/quentingenet.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Vinyl Keeper\n\n![React](https://img.shields.io/badge/react-%2320232a.svg?style=for-the-badge\u0026logo=react\u0026logoColor=%2361DAFB)\n![TypeScript](https://img.shields.io/badge/typescript-%23007ACC.svg?style=for-the-badge\u0026logo=typescript\u0026logoColor=white)\n![Python](https://img.shields.io/badge/python-3670A0?style=for-the-badge\u0026logo=python\u0026logoColor=ffdd54)\n![FastAPI](https://img.shields.io/badge/FastAPI-005571?style=for-the-badge\u0026logo=fastapi)\n![PostgreSQL](https://img.shields.io/badge/PostgreSQL-316192?style=for-the-badge\u0026logo=postgresql\u0026logoColor=white)\n![Debian](https://img.shields.io/badge/Debian-D70A53?style=for-the-badge\u0026logo=debian\u0026logoColor=white)\n![Raspberry Pi](https://img.shields.io/badge/-RaspberryPi-C51A4A?style=for-the-badge\u0026logo=Raspberry-Pi)\n\n**VinylKeeper** is a free and open-source application released under the Copyleft license.\n\u003cbr\u003eThis is your go-to solution to effortlessly manage your vinyl collection, while fully respecting your privacy and data ownership.\n\u003cbr\u003e\u003cbr\u003e [VinylKeeper.org](https://vinylkeeper.org/)\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://vinylkeeper.org/\"\u003e\n    \u003cimg src=\"https://github.com/quentingenet/vinylkeeper/blob/develop/vinylkeeper_preview.webp\" alt=\"VinylKeeper preview\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\n##  Features and Upcoming / In Progress\n\n📊 **Dashboard**  \nGet a quick overview of your collection with insightful stats: genres, decades, top artists, and more.\n\n📀 **Collections**  \nBrowse and manage your vinyl records, organized to your preferences.\n\n➕ **Add Vinyls**  \nAdd new vinyls manually or search via Deezer integration.\n\n🔍 **Explore**  \nDiscover artists and albums using a powerful search connected to the Deezer API.\n\n🎯 **Suggestions**  \nSmart recommendations based on your library and listening habits.\n\n💖 **Wishlist**  \nKeep track of the vinyls you’d love to add to your collection someday.\n\n🔄 **Loans**  \nManage borrowed vinyls—know what you lent, to whom, and when.\n\n⚙️ **Settings**  \nCustomize your profile, preferences, and account options.\n\n🌍 **Interactive map**  \nDiscover \u0026 share vinyl places around the world with the community.\n\n👥 **Community**  \nSee other users' collections, follow vinyl lovers, share discoveries and messages.\n\n🔐 **Secure Authentication**  \nJWT-based login, with refresh token handling via secure HTTPOnly cookies.\n\n📱 **Responsive \u0026 PWA-ready**  \nFully responsive UI, optimized for desktop and mobile, with Capacitor support for Progressive Web App deployment.\n\n🛠️ **Modern Architecture**  \nReact + TypeScript frontend (Vite), FastAPI backend (Python), PostgreSQL database.\n\n## Technologies\n\n**VinylKeeper** is developed using:\n- **[Python](https://www.python.org/)** with **[FastAPI](https://fastapi.tiangolo.com/)** for the main API.\n- **[React](https://reactjs.org)** and **[TypeScript](https://www.typescriptlang.org/)** with **[Vite.js](https://vitejs.dev/)** for the frontend\n- **[PostgreSQL](https://www.postgresql.org/)** for the database\n\n\n## How to run the project? (API Python \u0026 FastAPI)\n\n### Prerequisites\n\nEnsure the following are installed on your machine:\n\n- [Node.js](https://nodejs.org/)\n- [npm](https://www.npmjs.com/) or [yarn](https://yarnpkg.com/)\n- [Vite.js](https://vitejs.dev/)\n- [Python](https://www.python.org/)\n- [FastAPI](https://fastapi.tiangolo.com/)\n- [Poetry](https://python-poetry.org/)\n- [Docker and Docker compose](https://docs.docker.com/)\n\n### Clone the repository\n\n```bash\ngit clone https://github.com/quentingenet/vinylkeeper.git\n```\n**⚠️ Don't forget to create your own `.env.development` file using the provided `.env.template.contributors` as a reference.**\n\n### Backend Setup\nNavigate to the backend folder, install dependencies, and run migrations:\n\n```bash\ncd vinylkeeper/vinylkeeper_back\npoetry install\n# Run database migrations\npoetry run alembic upgrade head\n# Start the server\npoetry run uvicorn app.main:app --reload --host 0.0.0.0 --port 8000\n```\nThe backend server runs at **http://localhost:8000**\n- API documentation: **http://localhost:8000/docs**\n- Alternative docs: **http://localhost:8000/redoc**\n\n### Frontend Setup\nIn a separate terminal, navigate to the frontend folder, install dependencies, and start the server:\n\n```bash\ncd vinylkeeper/vinylkeeper_front\nnpm install\nnpm run dev\n```\nVisit **http://localhost:5173** in your browser to access the VinylKeeper application.\n\n## How to contribute?\n\nWe welcome contributions to improve Vinyl Keeper! To contribute:\n\n1. Fork this repository.\n2. Create a feature branch **from develop** (`git checkout -b feat/amazing-feature`).\n3. Commit your changes (`git commit -m 'Add some amazing feature'`).\n4. Push to the branch (`git push origin feat/amazing-feature`).\n5. Open a Pull Request.\n\nThe project promotes the four essential freedoms:\n1. Freedom to use the software.\n2. Freedom to modify the software.\n3. Freedom to share the software.\n4. Freedom to share your modifications.\n\n## Author and contributors\n\n- Quentin GENET\n- If you love vinyl, music, and web development, and are motivated to contribute seriously — we'd love to hear from you! 😄🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquentingenet%2Fvinylkeeper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquentingenet%2Fvinylkeeper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquentingenet%2Fvinylkeeper/lists"}