https://github.com/thenickmonaco/manslice
Java Midi Player component that lets you chop up beats like Ye using javafx and javax-sound-midi libraries
https://github.com/thenickmonaco/manslice
css fxml gradle java javafx javax-sound-midi midi-player
Last synced: 10 months ago
JSON representation
Java Midi Player component that lets you chop up beats like Ye using javafx and javax-sound-midi libraries
- Host: GitHub
- URL: https://github.com/thenickmonaco/manslice
- Owner: thenickmonaco
- License: mit
- Created: 2024-09-12T19:52:36.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-03T07:03:47.000Z (about 1 year ago)
- Last Synced: 2025-03-28T00:49:04.949Z (about 1 year ago)
- Topics: css, fxml, gradle, java, javafx, javax-sound-midi, midi-player
- Language: Java
- Homepage:
- Size: 525 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Video Demo
[](https://youtu.be/-5MFaZHH-rA)
# Portfolio Project
The purpose of this repo is to provide a framework for creating your own
component in the software sequence discipline.
## Recommended Steps to Get Started
When starting your portfolio project, the following steps should make your life
a bit easier.
### Step 1: Create a Repo From This Template
Assuming you're reading this README from GitHub, you can make use of this
repo by clicking the `Use this template` button in the top-right corner of
this page. If you can't find the button, [this link][use-this-template]
should work as well. Personally, I would recommend using the
`Create a new repository` option, which will allow you to name the
repository after your component. Given that you will be submitting pull
requests to me through Carmen, you'll want to make sure your repository
is public. Then, you can click `Create repository`. After that, you can
go through all the usual steps of cloning a repository on your system to
get to work. I use GitHub Desktop to clone projects, and it has a nice
feature of letting you open a repo directly in VSCode from the
`Repository` menu.
### Step 2: Install Recommended Plugins
When you open VSCode with this project, you should get a notification in the
bottom right corner that there are some recommended extensions to install.
Click install all. If you ignored this message or it never came up, feel free
to press CTRL+SHIFT+P and type "Show Recommended Extensions". Install all of the
extensions listed.
### Step 3: Install the Latest JDK
If you do not have an available JDK on your system, you may be prompted to
install one by VSCode. The default seems to be Red Hat's OpenJDK, which seems to
require you to register for an account or to install on the command line.
Regardless, there is no mac support. As a result, I would just recommend
installing the latest JDK [directly from Oracle's site][jdk-downloads].
### Step 4: Add Key Libraries to Project
As you are probably all aware at this point, you need the components jar to get
anything running. My advice is to [download it from here][components-jar]. Then,
drop it into the `lib` folder in the project. Git automatically ignores anything
you put here by default, so don't worry about committing it to version control.
Similarly, you will need the testing APIs (e.g., JUnit). Perhaps the easiest way
to include them in your project is to click the beaker symbol in the left
sidebar; it's right below the extensions button which looks like four squares.
If you do not see this button, try creating a Java file in `src`. From there,
you can click "Enable Java Tests" and then click "JUnit" from the
dropdown. That's it! You should now see the two JUnit libraries in the lib
folder.
**Note**: if you're using VSCode for class projects, you might be wondering
why you never had to do this. In general, it's bad practice to commit binaries
to version control. However, we have no way of managing dependencies with the
custom `components.jar`, so I included them directly in the template. I did not
include them here, so you could see how it might be done from scratch. If at any
point you're struggling with Step 3, just copy the lib folder from the monorepo
template.
## Next Steps
Now that you have everything setup, you can begin crafting your component. There
will be deadlines for each step in Carmen, but you're free to complete each step
as early as you'd like. To start, you'll want to visit the [doc](doc/) directory
for each assignment file.
[components-jar]: https://cse22x1.engineering.osu.edu/common/components.jar
[jdk-downloads]: https://www.oracle.com/java/technologies/downloads/
[use-this-template]: https://github.com/new?template_name=portfolio-project&template_owner=jrg94