Skip to content

🎧 Web MP3 Player ⏯️ and Media Library 🎡 Manager

License

Notifications You must be signed in to change notification settings

tbaltrushaitis/mp3web

Repository files navigation

Standard Version License

Web MP3 Player 🎧 and Media Library Manager

Web MP3 Player Logo

mp3 web player audio library manager


Live Demo

πŸ‘‰ Premium Music Collection πŸ‘ˆ


:octocat: Credits

Scope Role Name Version Description
Host Installer Composer 1.6.3 Dependency Manager for PHP
Back Engine Laravel 5.5.49 PHP Framework
Front Library require.js 2.3.6 A file and module loader for JavaScript
Front Library jQuery 3.5.1 JavaScript Library
Front Library Lodash 4.17.15 A modern JavaScript utility library delivering modularity, performance & extras.
Front Framework Bootstrap 3.3.7 HTML, CSS, and JS framework
Front Library Font-Awesome 4.7.0 The iconic font and CSS toolkit
Front Library Noty 2.4.1 A Dependency-free notification library
Front Library animate.css 3.7.2 A cross-browser library of CSS animations
Front Plugin BootstrapΒ Tagsinput 0.8.0 jQuery tags input plugin based on Twitter Bootstrap

Usage

1 - Download

$ git clone -b latest https://github.com/tbaltrushaitis/mp3web.git && cd mp3web

2 - Configure

Edit file src/.env.rc (or create your own, e.g. src/.env.rc.local) - change values of build variables in it (e.g. DB_HOST, APP_URL, etc.)

3 - Build

With make - GNU make utility to maintain groups of programs

In fact you just need to type in your terminal:

$ make

To get additional info and usage examples type make usage|help|list command:

$ make help
          β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
          β”‚   __  __ _____ ______          ________ ____    β”‚
          β”‚  |  \/  |  __ \___ \ \        / /  ____|  _ \   β”‚
          β”‚  | \  / | |__) |__) \ \  /\  / /| |__  | |_) |  β”‚
          β”‚  | |\/| |  ___/|__ < \ \/  \/ / |  __| |  _ <   β”‚
          β”‚  | |  | | |    ___) | \  /\  /  | |____| |_) |  β”‚
          β”‚  |_|  |_|_|   |____/   \/  \/   |______|____/   β”‚
          β”‚                                                 β”‚
          β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

---------------------------------------------------------
Available commands:
make
  list        - LIST all targets defined in this makefile
  clean       - CLEAR directories and delete files
  setup       - check for php, node and bower installations
  engine      - setup and build engine
  build       - BUILD project from sources
  release     - COMPILE project distro
  deploy      - DEPLOY compiled project to "webroot" directory
  all         - Run all operations for current stage from NODE_ENV file
  rebuild     - Execute [build, release, deploy] tasks
  redeploy    - Execute [release, deploy] tasks
---------------------------------------------------------

4 - Deploy

$ make all

5 - Enjoy


Directory structure

.
β”œβ”€β”€ .bowerrc              --> bower configuration
β”œβ”€β”€ .gitattributes        --> git editor settings
β”œβ”€β”€ .gitconfig            --> git client settings
β”œβ”€β”€ .gitignore            --> specifies untracked files to git
β”œβ”€β”€ .gitmodules           --> git submodules definition
β”œβ”€β”€ .jshintignore         --> specifies untracked files to jshint
β”œβ”€β”€ .npmrc                --> npm settings
β”œβ”€β”€ bower.json            --> specified third party libs & dependencies for frontend application
β”œβ”€β”€ gulpfile.js           --> configuration for gulp tasks
β”œβ”€β”€ Makefile              --> main orchestration scenario
β”œβ”€β”€ package.json          --> main project description file used by npm
β”œβ”€β”€ README.md             --> this file
β”œβ”€β”€ config                --> project configuration files
β”œβ”€β”€ dist                  --> compiled project
β”œβ”€β”€ node_modules          --> node modules
β”œβ”€β”€ src                   --> application sources
β”‚Β Β  β”œβ”€β”€ app               --> core code of server-side application
β”‚Β Β  β”‚   β”œβ”€β”€ Classes       --> project classes and objects
β”‚Β Β  β”‚   β”œβ”€β”€ Console       --> custom Artisan commands
β”‚Β Β  β”‚   β”œβ”€β”€ Events        --> houses event classes
β”‚Β Β  β”‚   β”œβ”€β”€ Exceptions    --> exception handler and is also a good place to hold any exceptions thrown by application
β”‚Β Β  β”‚   β”œβ”€β”€ Http          --> controllers, middleware, and form requests
β”‚Β Β  β”‚   β”œβ”€β”€ Jobs          --> TBD
β”‚Β Β  β”‚   β”œβ”€β”€ Listeners     --> N/A
β”‚Β Β  β”‚   β”œβ”€β”€ Mail          -->
β”‚Β Β  β”‚   β”œβ”€β”€ Notifications -->
β”‚Β Β  β”‚   β”œβ”€β”€ Policies      -->
β”‚Β Β  β”‚   β”œβ”€β”€ Providers     -->
β”‚Β Β  β”‚   β”œβ”€β”€ Rules         -->
β”‚Β Β  β”‚   β”œβ”€β”€ Repositories  -->
β”‚Β Β  β”‚   β”œβ”€β”€ Common        --> common factories, services, directives, filters, helpers for all project
β”‚Β Β  β”œβ”€β”€ bootstrap         --> files which bootstraps the framework
β”‚Β Β  β”œβ”€β”€ config            --> application configuration files
β”‚Β Β  β”œβ”€β”€ database          --> database migrations, model factories, and seeds
β”‚Β Β  β”œβ”€β”€ public            --> entry point for all requests entering your application
β”‚Β Β  β”œβ”€β”€ resources         --> contains views as well as raw, un-compiled assets such as LESS, SASS, or JavaScript
|   β”‚Β Β  β”œβ”€β”€ assets        --> folder for application assets
|   β”‚Β Β  β”‚   β”œβ”€β”€fonts      --> folder for application fonts
|   β”‚Β Β  β”‚   β”œβ”€β”€i18n       --> internationalization
|   β”‚Β Β  β”‚   β”œβ”€β”€img        --> folder for application images
|   β”‚Β Β  β”‚   β”œβ”€β”€css        --> application stylesheets and theme settings
|   β”‚Β Β  β”‚   β”œβ”€β”€js         --> javascript files
|   β”‚Β Β  β”‚      β”œβ”€β”€app     --> application scripts
|   β”‚Β Β  β”‚      β”œβ”€β”€lib     --> third party libs
|   β”‚Β Β  β”œβ”€β”€ views         --> raw Blade templates
β”‚Β Β  β”œβ”€β”€ routes            --> route definitions for application
β”‚Β Β  β”œβ”€β”€ storage           --> compiled Blade templates, sessions, caches, and other files generated by the framework
β”‚Β Β  β”œβ”€β”€ tests             --> automated tests
β”‚Β Β  β”œβ”€β”€ vendor            --> contains Composer dependencies

TODO List

  • Implement search through items.

CHANGELOG

See Changelog file for details


πŸ”— More Info


πŸ“† Developed on 11th of September 2016

♏