{"id":16212482,"url":"https://github.com/temzasse/soundfusion","last_synced_at":"2025-10-28T18:13:35.631Z","repository":{"id":87469926,"uuid":"93198981","full_name":"Temzasse/soundfusion","owner":"Temzasse","description":"A prototype music player app made with Electron, React, Redux and other cool kid's toys.","archived":false,"fork":false,"pushed_at":"2017-08-27T14:33:09.000Z","size":3583,"stargazers_count":8,"open_issues_count":8,"forks_count":1,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-02-28T17:46:49.650Z","etag":null,"topics":["electron","music-player","pouchdb","reactjs","redux","redux-saga"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/Temzasse.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}},"created_at":"2017-06-02T19:50:02.000Z","updated_at":"2020-11-02T15:04:45.000Z","dependencies_parsed_at":null,"dependency_job_id":"248c24a6-dde2-46ae-bf73-a9782a1f6b04","html_url":"https://github.com/Temzasse/soundfusion","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Temzasse%2Fsoundfusion","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Temzasse%2Fsoundfusion/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Temzasse%2Fsoundfusion/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Temzasse%2Fsoundfusion/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Temzasse","download_url":"https://codeload.github.com/Temzasse/soundfusion/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243982141,"owners_count":20378605,"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":["electron","music-player","pouchdb","reactjs","redux","redux-saga"],"created_at":"2024-10-10T10:52:32.262Z","updated_at":"2025-10-28T18:13:34.487Z","avatar_url":"https://github.com/Temzasse.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align='center'\u003e\n  \u003cimg src=\"assets/icon.png\" height=\"120\"/\u003e\n\u003cp/\u003e\n\n# SoundFusion\n\nSoundFusion is a music player app that finds tracks from various sources to create personal playlists (YouTube and SoundCloud at the moment).\n\n\u003cp align='center'\u003e\n  \u003cimg src=\"media/screenshot_1.png\" width=\"100%\"/\u003e\n\u003cp/\u003e\n\nThe idea for this app was born from the desire to learn [Electron](https://github.com/electron/electron) and build my first desktop app ever.\n\n---\n\n## Usage\n\nYou can download the app directly:\n\n**Mac OSX**: [zip](https://s3.eu-central-1.amazonaws.com/soundfusion/SoundFusion-1.0.0-mac.zip) | [dmg](https://s3.eu-central-1.amazonaws.com/soundfusion/SoundFusion-1.0.0.dmg)\n\n**Windows**: TODO...\n\nOr if you fancy a more hands-on installation process then first clone this repo:\n```\n$ git clone git@github.com:Temzasse/soundfusion.git\n```\n\nThen install dependencies:\n```\n$ npm install\n```\n\nNext, in order for the app to work it needs API keys for [YouTube](https://developers.google.com/youtube/v3/getting-started) and [SoundCloud](https://developers.soundcloud.com/).\nUnfortunately at the moment SoundCloud doesn't issue any new API keys so you're better of downloading the app directly (check links above).\n\nIf you happen to have both of the API keys required you need to copy the `config-template.js` to `config.js` under *src* and put you keys there.\n\nFinally, you can package the app:\n```\n$ npm run pack\n```\n\nAfter [electron-builder](https://github.com/electron-userland/electron-builder) is ready you will find the app under *dist* folder.\n\n\u003e**Disclaimer:** YouTube doesn't allow using videos as music without showing the actual video. I might try to add the video element somewhere but at the moment this is purely a personal project for learning Electron and I feel that things are fine as they are.\n\n## Development\n\nInstall dependencies:\n```\n$ npm install\n```\n\nCopy `src/config-template.js` as `src/config.js` and fill in your API keys as described above.\n\nRun app in dev mode:\n```\n$ npm run dev\n```\n\nAnd if you are on Windows:\n```\n$ npm run dev:win\n```\n\n**NOTE:** the app will most likely crash without valid API keys...\n\n## TODO\n\n### Fixes\n\n- Allow using only one of the sources if some of the API keys are missing / invalid.\n- App should not crash if one of the sources does not work.\n\n### Features\n\n- Shuffle.\n- Volume control.\n- Add more music sources (check out [Bandcamp](https://bandcamp.com/developer)).\n- Feature suggestions are more than welcome :)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftemzasse%2Fsoundfusion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftemzasse%2Fsoundfusion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftemzasse%2Fsoundfusion/lists"}