pistondevelopers / music Goto Github PK

View Code? Open in Web Editor NEW

40.0 44.0 5.0 997 KB

A high level library for playing music and sound effects

License: Apache License 2.0

Rust 100.00%

music's People

Contributors

Stargazers

Watchers

Forkers

bvssvni jamartin9 vignesh-sankaran songwithoutwords atul9

music's Issues

rust-sdl2_mixer is deprecated

See https://github.com/andelf/rust-sdl2_mixer

Get length and state of music in seconds

Cannot build on stable 0.11.0 due to unstable feature 'reflect_marker'

Creating a new issue as this is technically different than #18, which I think can be closed.

Cannot build on Rust 0.11.0 due to #![feature(reflect_marker)]

While trying to learn more about Reflect, I came across a thread talking about potential plans to deprecate and remove Reflect, so that could be added incentive to remove its use here.

"C:\Users\John Hagen\.cargo\bin\cargo.exe" run
    Updating registry `https://github.com/rust-lang/crates.io-index`
    Blocking waiting for file lock on the registry index
 Downloading piston-music v0.12.0
 Downloading current v0.1.2
    Blocking waiting for file lock on sdl2-sys-0.22.0.crate
   Compiling current v0.1.2
   Compiling sdl2-sys v0.22.0
   Compiling num v0.1.35
   Compiling enum_primitive v0.1.0
   Compiling ndarray v0.3.1
   Compiling image v0.10.3
   Compiling sdl2 v0.22.0
   Compiling rusttype v0.2.0
   Compiling sdl2_mixer v0.22.0
   Compiling piston-music v0.12.0
C:\Users\John Hagen\.cargo\registry\src\github.com-1ecc6299db9ec823\piston-music-0.12.0\src/lib.rs:1:1: 1:28 error: #[feature] may not be used on the stable release channel [E0554]
C:\Users\John Hagen\.cargo\registry\src\github.com-1ecc6299db9ec823\piston-music-0.12.0\src/lib.rs:1 #![feature(reflect_marker)]
                                                                                                     ^~~~~~~~~~~~~~~~~~~~~~~~~~~
error: aborting due to previous error
Build failed, waiting for other jobs to finish...
error: Could not compile `piston-music`.

To learn more, run the command again with --verbose.

Process finished with exit code 101

The piano.wav example works great, but when I try to substitute an .mp3 file, the program runs, but I don't hear anything. I'm not sure whether it is a problem with the file type or something else. Having an example that is known to work would be helpful.

Add Travis CI Build

Placeholder for completing #30 PR work.

Would help clarify questions like #31 if there was a Travis build to inspect.

pistoncore-current has been renamed to current

This package depends on pistoncore-current which was renamed to current.

no matching package named `pistoncore-current` found (required by `piston-music`)
location searched: https://github.com/pistondevelopers/current

PistonDevelopers/current#81

"Current" dependency does not compile

I keep getting this error when trying to compile a simple "hello_world" using piston and the music library (Rust v1.10.0):

Compiling current v0.1.1
     Running "rustc /home/michael/.cargo/registry/src/github.com-1ecc6299db9ec823/current-0.1.1/src/lib.rs --crate-name current --crate-type lib -g -C metadata=302fdaf8a95a5bdd -C extra-filename=-302fdaf8a95a5bdd --out-dir /home/michael/Code/Rust/hello_music/target/debug/deps --emit=dep-info,link -L dependency=/home/michael/Code/Rust/hello_music/target/debug/deps -L dependency=/home/michael/Code/Rust/hello_music/target/debug/deps --cap-lints allow"
/home/michael/.cargo/registry/src/github.com-1ecc6299db9ec823/current-0.1.1/src/lib.rs:2:1: 2:29 error: #[feature] may not be used on the stable release channel
/home/michael/.cargo/registry/src/github.com-1ecc6299db9ec823/current-0.1.1/src/lib.rs:2 #![feature(core_intrinsics)]
                                                                                         ^~~~~~~~~~~~~~~~~~~~~~~~~~~~
error: aborting due to previous error
Build failed, waiting for other jobs to finish...
error: Could not compile "current".

Caused by:
  Process didn't exit successfully: "rustc /home/michael/.cargo/registry/src/github.com-1ecc6299db9ec823/current-0.1.1/src/lib.rs --crate-name current --crate-type lib -g -C metadata=302fdaf8a95a5bdd -C extra-filename=-302fdaf8a95a5bdd --out-dir /home/michael/Code/Rust/hello_music/target/debug/deps --emit=dep-info,link -L dependency=/home/michael/Code/Rust/hello_music/target/debug/deps -L dependency=/home/michael/Code/Rust/hello_music/target/debug/deps --cap-lints allow" (exit code: 101)

My Cargo.toml file has the dependencies "piston_window" and "piston-music" set to their proper versions.

--EDIT--

I see now that the issue may be that I'm compiling this with Rust "stable". Is there a way we can get this library to work without resorting to using the "nightly" version of Rust?

Add section in README about dependancies

I'm trying to add some music to a very simple game, keeping it as simple as possible at first as I learn. Is piston-music the correct library to use for this? I'm trying to keep the build steps / external dependencies low.

I was able to build piston-music 0.13.0 using stable Rust 0.11.0 on Windows 10, but when I get to the linker step:

"C:\Users\John Hagen\.cargo\bin\cargo.exe" run
   Compiling rust_belt v0.1.0 (file:///C:/Users/John%20Hagen/PycharmProjects/rust_belt)
error: linking with `gcc` failed: exit code: 1
note: "gcc" "-Wl,--enable-long-section-names" "-fno-use-linker-plugin" "-Wl,--nxcompat" "-nostdlib" "-m64" "C:\\Users\\John Hagen\\.multirust\\toolchains\\stable-x86_64-pc-windows-gnu\\lib\\rustlib\\x86_64-pc-windows-gnu\\lib\\crt2.o" "C:\\Users\\John Hagen\\.multirust\\toolchains\\stable-x86_64-pc-windows-gnu\\lib\\rustlib\\x86_64-pc-windows-gnu\\lib\\rsbegin.o" "-L" "C:\\Users\\John Hagen\\.multirust\\toolchains\\stable-x86_64-pc-windows-gnu\\lib\\rustlib\\x86_64-pc-windows-gnu\\lib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\rust_belt.0.o" "-o" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\rust_belt.exe" "-Wl,--gc-sections" "-nodefaultlibs" "-L" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug" "-L" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps" "-L" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\build\\miniz-sys-60c8d67696f63a43\\out" "-L" "C:\\Users\\John Hagen\\.cargo\\registry\\src\\github.com-1ecc6299db9ec823\\dwmapi-sys-0.1.0/x86_64" "-L" "C:\\Users\\John Hagen\\.multirust\\toolchains\\stable-x86_64-pc-windows-gnu\\lib\\rustlib\\x86_64-pc-windows-gnu\\lib" "-Wl,-Bstatic" "-Wl,-Bdynamic" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libfind_folder-85e661d6af761082.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libmusic-c41a3137cec014bf.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libsdl2_mixer-171421cecbd3890d.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libsdl2-99eee13a97cfac5c.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libcurrent-cd5bbeb14dbb8518.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libpiston_window-f1a7339ccd920121.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libglutin_window-7ca4ce7285cb65ad.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libglutin-ebb328a8f56d2941.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libdwmapi-b7b4ef7bb14c9654.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libuser32-ab4e7be30af20d1b.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libgdi32-37f11392e9ac4edd.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libshell32-1cd19799b8066c32.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libkernel32-df86a08647459244.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libwinapi-0889532d327ff4e2.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libshared_library-94c5183073084fbf.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libgfx_graphics-a5bbe2547ec219a9.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\librusttype-7dce2562d41e028d.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\liblinked_hash_map-8bca62f90f0f04c7.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libndarray-c26d51e4b85be5eb.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libitertools-6ed54d426567906b.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libstb_truetype-159d3ced5bac15cb.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libbyteorder-7a494f72a43262ac.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libarrayvec-722bef18c53ff0e7.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libnodrop-c91b77174658f4ef.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libodds-e71bf2d7834329e1.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libshaders_graphics2d-574001b4272bccea.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libgraphics-bf08eea27a89d49e.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libinterpolation-26420a82c583f0b1.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libread_color-eb34d097612ac965.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libvecmath-91e4c22bc2d512af.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libgfx_texture-1b3ab46d4fd1c4b1.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libimage-1ef1c5676f65109e.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libscoped_threadpool-c9a9d52c8af25eca.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libgif-9f13a06f8f49267e.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libcolor_quant-ccb3bfc104102a50.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\liblzw-6ef9d38d31cf3d1c.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libjpeg_decoder-e7f902581e17f586.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\librayon-61000d8122c1ee9a.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libdeque-82214e5f75d78bdf.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libpng-47615b6a63061b53.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libflate2-d719035eaa7c6a88.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libminiz_sys-722889de4af2439c.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libinflate-3b154d39385bf8a5.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libbyteorder-e4fc6ea0c49cabcf.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libenum_primitive-77b731c79b5cdf4e.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libnum-45a7f1df1ffbcf4c.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libnum_rational-7726582d22be0b52.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libnum_bigint-a144dbec313e5e23.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\librand-49a08859d086fffe.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libnum_iter-50df698bc905252c.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libnum_integer-52fdddf28cd8e924.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libtexture-e75555caa875ee44.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libgfx_device_gl-f3e972e45450a75d.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libgfx_gl-b7e8551f5d537140.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libgfx-436a84f17e44abf2.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libgfx_core-c138efaf774bac65.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libdraw_state-196f0a026baef11a.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\liblog-bf16bb9a4912b11d.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libpiston-ffee518c7f99c390.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libevent_loop-86d72c26cce68995.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libwindow-60a14deb18893c87.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libshader_version-b8072d7c2b12472d.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libinput-2eeadab8b08583f9.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libbitflags-0e272044714c8076.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libbitflags-b8c7fb7df9b2bc2e.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libgl-f86824b65a1d579a.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libnum_cpus-9256729e2e3ab66d.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libviewport-d1b29131e8c075c9.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libfloat-5f568cf52eab6ad2.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\liblazy_static-359f5533c970cd71.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libsdl2_sys-f2b6c7dfddd5d66c.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\liblibc-1bd8847afb79f283.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libnum_complex-704ef091ce88b7b2.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\librustc_serialize-3561541d79c18212.rlib" "C:\\Users\\John Hagen\\PycharmProjects\\rust_belt\\target\\debug\\deps\\libnum_traits-a6dde7de4ab4b779.rlib" "C:\\Users\\John Hagen\\.multirust\\toolchains\\stable-x86_64-pc-windows-gnu\\lib\\rustlib\\x86_64-pc-windows-gnu\\lib\\libstd-39b92f95.rlib" "C:\\Users\\John Hagen\\.multirust\\toolchains\\stable-x86_64-pc-windows-gnu\\lib\\rustlib\\x86_64-pc-windows-gnu\\lib\\libpanic_unwind-39b92f95.rlib" "C:\\Users\\John Hagen\\.multirust\\toolchains\\stable-x86_64-pc-windows-gnu\\lib\\rustlib\\x86_64-pc-windows-gnu\\lib\\libunwind-39b92f95.rlib" "C:\\Users\\John Hagen\\.multirust\\toolchains\\stable-x86_64-pc-windows-gnu\\lib\\rustlib\\x86_64-pc-windows-gnu\\lib\\liblibc-39b92f95.rlib" "C:\\Users\\John Hagen\\.multirust\\toolchains\\stable-x86_64-pc-windows-gnu\\lib\\rustlib\\x86_64-pc-windows-gnu\\lib\\librand-39b92f95.rlib" "C:\\Users\\John Hagen\\.multirust\\toolchains\\stable-x86_64-pc-windows-gnu\\lib\\rustlib\\x86_64-pc-windows-gnu\\lib\\libcollections-39b92f95.rlib" "C:\\Users\\John Hagen\\.multirust\\toolchains\\stable-x86_64-pc-windows-gnu\\lib\\rustlib\\x86_64-pc-windows-gnu\\lib\\liballoc-39b92f95.rlib" "C:\\Users\\John Hagen\\.multirust\\toolchains\\stable-x86_64-pc-windows-gnu\\lib\\rustlib\\x86_64-pc-windows-gnu\\lib\\liballoc_system-39b92f95.rlib" "C:\\Users\\John Hagen\\.multirust\\toolchains\\stable-x86_64-pc-windows-gnu\\lib\\rustlib\\x86_64-pc-windows-gnu\\lib\\librustc_unicode-39b92f95.rlib" "C:\\Users\\John Hagen\\.multirust\\toolchains\\stable-x86_64-pc-windows-gnu\\lib\\rustlib\\x86_64-pc-windows-gnu\\lib\\libcore-39b92f95.rlib" "-l" "SDL2_mixer" "-l" "opengl32" "-l" "dwmapi" "-l" "user32" "-l" "gdi32" "-l" "shell32" "-l" "kernel32" "-l" "advapi32" "-l" "SDL2" "-l" "SDL2" "-l" "ws2_32" "-l" "userenv" "-l" "shell32" "-l" "advapi32" "-l" "gcc_eh" "-l" "compiler-rt" "-lmingwex" "-lmingw32" "-lgcc" "-lmsvcrt" "-luser32" "-lkernel32" "C:\\Users\\John Hagen\\.multirust\\toolchains\\stable-x86_64-pc-windows-gnu\\lib\\rustlib\\x86_64-pc-windows-gnu\\lib\\rsend.o"
note: ld: cannot find -lSDL2_mixer
ld: cannot find -lSDL2
ld: cannot find -lSDL2

error: aborting due to previous error
error: Could not compile `rust_belt`.

To learn more, run the command again with --verbose.

Process finished with exit code 101

I'm using MSYS2 for my gcc implementation.

I would suggest adding a section in the README about the SDL dependencies for new developers.

I was able to get it to work with a combination of:

rust-sdl2 requirements
And andelf/rust-sdl2_mixer#54. (rust-sdl2_mixer instructions)

Secondarily, does there exist a pure Rust alternative the avoid these external dependencies?

Not compatible with "[email protected]"

It seems the version of "sdl2" is conflict.

... dependency `sdl2 = "^0.34.0"` of package `piston-music v0.26.0`

... dependency `sdl2 = "^0.35.2"` of package `pistoncore-sdl2_window v0.68.0`

Would you please update this crate, thank you very much.

Binding two different types of files crashes application

If a .mp3 file and then a .wav file are bound, the program crashes (at least on Windows 10). Ideally, we should catch this if it's really a limitation of SDL2 and print a helpful error message.

Simple volume control

play could add another argument, volume to allow the calling program simple control over how loud the track should be played.

Is Nightly required to build?

I don't want to use Rust Nightly in order to use this library. Is that a requirement in order to build? Please let me know.

Error: "Feature may not be used on stable release channel"

I currently cannot compile "piston-music":

/home/username/.cargo/registry/src/github.com-1ecc6299db9ec823/current-0.1.1/src/lib.rs:2:1: 2:29 error: #[feature] may not be used on the stable release channel [E0554]
/home/username/.cargo/registry/src/github.com-1ecc6299db9ec823/current-0.1.1/src/lib.rs:2 #![feature(core_intrinsics)]
                                                                                         ^~~~~~~~~~~~~~~~~~~~~~~~~~~~
error: aborting due to previous error
Build failed, waiting for other jobs to finish...
error: Could not compile `current`.

Cannot play MP3 on OSX

/Users/hagenjt1/.cargo/bin/cargo run --example test-mp3
   Compiling sdl2-sys v0.24.0
   Compiling piston_window v0.54.0
   Compiling sdl2 v0.24.0
   Compiling sdl2_mixer v0.24.0
   Compiling piston-music v0.16.0 (file:///Users/hagenjt1/GitHub/music)
    Finished debug [unoptimized + debuginfo] target(s) in 7.44 secs
     Running `target/debug/examples/test-mp3`
2016-10-23 20:43:02.240 test-mp3[4344:28673] 20:43:02.239 WARNING:  140: This application, or a library it uses, is using the deprecated Carbon Component Manager for hosting Audio Units. Support for this will be removed in a future release. Also, this makes the host incompatible with version 3 audio units. Please transition to the API's in AudioComponent.h.
thread 'main' panicked at 'called `Result::unwrap()` on an `Err` value: "Unrecognized music format"', ../src/libcore/result.rs:788
note: Run with `RUST_BACKTRACE=1` for a backtrace.
error: Process didn't exit successfully: `target/debug/examples/test-mp3` (exit code: 101)

Process finished with exit code 101

Placeholder as I try to investigate this in case others run into this problem. It feels like this problem is likely upstream of piston-music though.

Potentially related: andelf/rust-sdl2_mixer#59

Tested on

OSX 10.11.6
Stable Rust 1.12.1

Minor instruction addition

For the newbie Rust guy who things that game development is a good starting point. Maybe a little additional information on how to run the examples:

cargo run --example test-mp3

Relicense under dual MIT/Apache-2.0

This issue was automatically generated. Feel free to close without ceremony if
you do not agree with re-licensing or if it is not possible for other reasons.
Respond to @cmr with any questions or concerns, or pop over to
#rust-offtopic on IRC to discuss.

You're receiving this because someone (perhaps the project maintainer)
published a crates.io package with the license as "MIT" xor "Apache-2.0" and
the repository field pointing here.

TL;DR the Rust ecosystem is largely Apache-2.0. Being available under that
license is good for interoperation. The MIT license as an add-on can be nice
for GPLv2 projects to use your code.

Why?

The MIT license requires reproducing countless copies of the same copyright
header with different names in the copyright field, for every MIT library in
use. The Apache license does not have this drawback. However, this is not the
primary motivation for me creating these issues. The Apache license also has
protections from patent trolls and an explicit contribution licensing clause.
However, the Apache license is incompatible with GPLv2. This is why Rust is
dual-licensed as MIT/Apache (the "primary" license being Apache, MIT only for
GPLv2 compat), and doing so would be wise for this project. This also makes
this crate suitable for inclusion and unrestricted sharing in the Rust
standard distribution and other projects using dual MIT/Apache, such as my
personal ulterior motive, the Robigalia project.

Some ask, "Does this really apply to binary redistributions? Does MIT really
require reproducing the whole thing?" I'm not a lawyer, and I can't give legal
advice, but some Google Android apps include open source attributions using
this interpretation. Others also agree with
it.
But, again, the copyright notice redistribution is not the primary motivation
for the dual-licensing. It's stronger protections to licensees and better
interoperation with the wider Rust ecosystem.

How?

To do this, get explicit approval from each contributor of copyrightable work
(as not all contributions qualify for copyright, due to not being a "creative
work", e.g. a typo fix) and then add the following to your README:

## License

Licensed under either of

 * Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
 * MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)

at your option.

### Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any
additional terms or conditions.

and in your license headers, if you have them, use the following boilerplate
(based on that used in Rust):

// Copyright 2016 music developers
//
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
// option. This file may not be copied, modified, or distributed
// except according to those terms.

It's commonly asked whether license headers are required. I'm not comfortable
making an official recommendation either way, but the Apache license
recommends it in their appendix on how to use the license.

Be sure to add the relevant LICENSE-{MIT,APACHE} files. You can copy these
from the Rust repo for a plain-text
version.

And don't forget to update the license metadata in your Cargo.toml to:

license = "MIT/Apache-2.0"

I'll be going through projects which agree to be relicensed and have approval
by the necessary contributors and doing this changes, so feel free to leave
the heavy lifting to me!

Contributor checkoff

To agree to relicensing, comment with :

I license past and future contributions under the dual MIT/Apache-2.0 license, allowing licensees to chose either at their option.

Or, if you're a contributor, you can check the box in this repo next to your
name. My scripts will pick this exact phrase up and check your checkbox, but
I'll come through and manually review this issue later as well.

@bvssvni

Use "bundled" SDL2 feature

If we use https://github.com/Rust-SDL2/rust-sdl2#bundled-feature, then users won't need to install SDL2 out of band, which would be a big usability bump.

This can't be completed until 'mixer' is also bundled: Rust-SDL2/rust-sdl2#778

Enable Appveyor CI

@bvssvni Can you enable AppVeyor so that we can have Windows coverage?

https://ci.appveyor.com/project/PistonDevelopers/music

We already have an appveyor.yml, we just need to enable the CI

OpenAL/Vorbis

OpenAL bindings https://github.com/bjz/openal-rs

Vorbis https://github.com/tomaka/vorbis-rs

How does this relate to rust-media?

Could we consolidate this effort with https://github.com/pcwalton/rust-media ?

Recommend Projects

React

A declarative, efficient, and flexible JavaScript library for building user interfaces.
Vue.js

🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript

TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
TensorFlow

An Open Source Machine Learning Framework for Everyone
Django

The Web framework for perfectionists with deadlines.
Laravel

A PHP framework for web artisans
D3

Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

javascript

JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
web

Some thing interesting about web. New door for the world.
server

A server is a program made to process requests and deliver data to clients.
Machine learning

Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Visualization

Some thing interesting about visualization, use data art
Game

Some thing interesting about game, make everyone happy.

Recommend Org

Facebook

We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft

Open source projects and samples from Microsoft.
Google

Google ❤️ Open Source for everyone.
Alibaba

Alibaba Open Source for everyone
D3

Data-Driven Documents codes.
Tencent

China tencent open source team.