Skip to content

Manage tabs, chords, and sheet music in Dropbox, and access and edit them directly in the browser, anywhere.

License

Notifications You must be signed in to change notification settings

gregtatum/browser-chords

Repository files navigation

🎵 Browser Chords

Manage tabs, chords, and sheet music in Dropbox, and access and edit them directly in the browser, anywhere.

This is a side project to make it easier for me to manage my music collection, and maintain control of the files simply through Dropbox. Many apps can lock you into their systems, but this one focuses on just having files that you are in control of. It purely runs on the front-end, and then access the Dropbox API to handle the file management.

Architecture

The front-end is built in TypeScript using React for the component system. It is using React Hooks and functional components for the component management. The state is centrally controlled using Redux. The state is accessed using selectors and the reselect to provide functional memoization for state changes.

The build process is managed by Webpack. Hosting is done through Netlify. The routing of the URLs is all handled through the front-end. Testing is handled through Jest and React Testing Library.

Dropbox uses an in-browser PKCE OAuth flow to securely log you in. This app gets access to a subfolder in the Dropbox/Apps folder to limit the access to

Supported Formats

ChordPro

This project supports basic ChordPro (.chopro) files for viewing and editing, with more of the features of the format planned for implementation.

Planned features include, but are not limited to:

  • Chord transposing
  • Styling directives

PDF

PDF Files are rendered directly in the browser through PDF.js. This is great for playing sheet music on tablets.

Planned formats

  • Image formats browsers can natively render, such as .jpg, .png
  • Musescore files (viewing only)

Additional planned/stretch features

  • Auto-scrolling
  • Spotify integration
  • Dropbox mp3 play-along integration

License

The code is open source licensed as GPLv3.

About

Manage tabs, chords, and sheet music in Dropbox, and access and edit them directly in the browser, anywhere.

Topics

Resources

License

Stars

Watchers

Forks