jaap3 / pti-tools Goto Github PK

View Code? Open in Web Editor NEW

60.0 5.0 5.0 1.72 MB

Turn a collection of samples into a beat sliced Polyend Tracker instrument

Home Page: https://jaap3.github.io/pti-tools/

License: ISC License

Dockerfile 0.34% HTML 1.36% TypeScript 45.09% Vue 53.03% Shell 0.18%

drumkit instrument polyend polyend-tracker pti 1010music dirtywave 1010music-blackbox dirtywave-m8

pti-tools's Introduction

Stich & Slice

Create beat sliced instruments for the Polyend Tracker in the browser. Load audio files and export a perfectly sliced .pti file.

Features

Load audio files and concatenate
Layer multiple samples per slice
Trim silence from the beginning and end of samples (per slice/layer)
Control volume per slice/layer
Export .pti files with slice markers
Export .wav files with cue points (usable on other devices/software, e.g. the Dirtywave M8 or the 1010music Blackbox)

Try it now: jaap3.github.io/pti-tools.

Written in Vue 3 and TypeScript.

Development

Use Docker Compose to run the development environment.

docker-compose build
docker-compose up

This will build the project and run the development server.

Once the server is up and running you can view the project in the browser at http://localhost:5173/.

Contributing

Contributions are welcome!

Fork the repository and make a pull request.
Create an issue to report a bug or suggest a feature.

Reporting bugs

Make sure to include the following information when reporting bugs:

Steps to reproduce the bug
Expected behavior
Actual behavior
The version and name of the browser/operating system in use
Screenshots/screencapture if applicable/possible

Suggesting features

Make sure to include the following information when suggesting features:

Description of the feature
Expected behavior
UI design/mockup (if applicable)

Making a pull request

Make sure the pull request relates to an issue (bug report or feature request), i.e. do not fix a bug or implement a feature without first creating an issue to describe it.

Pull requests representing a minor change (e.g. fixing a typo or adding a comment) are excempt from this rule.

All pull requests should pass linting and unit tests. There is no guarantee that a pull request will be accepted.

Disclaimer

This tool is not associated with Polyend. Use at your own risk.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

pti-tools's People

Stargazers

Watchers

Forkers

colonel-blimp allthecodedev metamorphart vnys propapanda

pti-tools's Issues

Add a way to restore recently deleted samples

It's easy to accidentally delete a slice or layer. Some way to restore it would be greatly appreciated.

Sound keeps playing after closing the layer screen

Load a long sample
Open the layer screen
Play the sample
While the sample is playing, close the screen

I'd expect the sound to stop, but instead it just keeps playing

.wav export, with cue markers

Add the option to download .wav files with embedded cue markers.

This would make this tool useable for people using the Dirtywave M8 and possible Renoise as well.

A dropdown to select the file format could be added next to the download button (defaulting to .pti).

The wavefile library is able to create .wav files with embedded cue markers. The API looks pretty straightforward as well.

Prevent loading overly long samples

The Tracker has a limit on sample length, avoid loading samples that go over this limit. (TODO: figure out this limit).

There should be a notification to the user when this happens.

Notify the user when samples aren't loaded

If a user selects (or drops) > 48 files anything past this limit is ignored. It would be nice to show a message when this happens.

Lint/format CSS

Use style lint to lint CSS, investigate best settings/plugins etc.

Adjust offset of layers

Allow the start of a layers to be shifted forwards.

This could be used to delay the start of additional sound.

I'd imagine some sort of input that would allow me to enter an offset in milliseconds. It could als be useful if the waveform display of the slice somehow reflected the offset of layers. Maybe by adding a marker? Definitely only when the layer editor is active

Avoid exporting overly long instruments

It is likely that loading up to 48 samples will exceed the maximum sample length of the Tracker. Notify the user when that happens and disable the download button.

Add drag and drop

It's more fun to drag slices around

Adjust tuning of slices and layers

Please make it possible to create variations of sounds by adding (fine)tune controls. These would allow to adjust the playback rate of the sample in semitones and cents.

I'm imagining two range inputs, similar to the pti-file-inspector.

Read cue markers from .wav file

It would be nice if slices were created automatically when loading a single .wav file with cue points. That way it would be possible to export a sliced file and edit it again later.

Show the length of each slice

It would be useful to know how long each slice is. Show the duration in ms/s.

Trim samples

Because of memory limitations any silence at the start/end of a slice is a waste of space. If possible, add an option to trim the start/end (or both) of a slice.

REX to PTI?

Possible to add REX file converting? Upload .rex or .rx2 file and the app spits out sliced .pti file.

Reuse loaded / created slices

It would be cool if it was possible to pick a sample from the currently loaded samples. This would help with layering sounds, e.g. when creating a kick + hihat it would be easy to pick from the list of sounds loaded. It would be even cooler if layered samples where also available, so reusing the layers kick + hihat to add a snare

Add a way to stop playing a sample

Once a sample is playing the only way to stop it is to start playing another sample. Turn the play button into a stop button while the sample is playing.

Add a way to control slice volume

Samples may vary widely in volume, this makes it hard to create instruments where all slices are usable. Add a way to control the volume per slice. This is especially useful when layering samples, to avoid clipping etc.

I'd expect some way to input the amount of gain (positive/negative) directly and/or a slider.

Load directories

Besides dropping files it would be nice to be able to drop an entire directory.

Currently dropping a directory does nothing. I'd like to drop a directory and load all the files inside it in one go.

Sort imports

Turn on eslint import sorting, investigate best practices. See if something similar to what isort does for python is possible.

Adjust start endpoint of samples

Please make it possible to adjust the start and end position of a layer. In effect this would make it possible to cut a part of the start and/or end of a sound.

I imagine this would be controlled by a set of inputs that allow me to set the start/endpoint in milliseconds. It would be nice if the playback region was also represented in the waveform display.

Note that this is seperate from #60, which is about shifting the moment in time the sample would start playing.