https://github.com/pepijn-devries/protrackr
R package that handles Commodore Amiga ProTracker file format. Official release available via CRAN. Install using: install.packages("ProTrackR")
https://github.com/pepijn-devries/protrackr
amiga audio modules retrocomputing
Last synced: 8 months ago
JSON representation
R package that handles Commodore Amiga ProTracker file format. Official release available via CRAN. Install using: install.packages("ProTrackR")
- Host: GitHub
- URL: https://github.com/pepijn-devries/protrackr
- Owner: pepijn-devries
- License: gpl-3.0
- Created: 2021-08-16T09:16:19.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2025-01-12T19:42:54.000Z (over 1 year ago)
- Last Synced: 2025-08-30T10:48:01.946Z (10 months ago)
- Topics: amiga, audio, modules, retrocomputing
- Language: R
- Homepage: https://pepijn-devries.github.io/ProTrackR/
- Size: 5.62 MB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.Rmd
- Changelog: NEWS.md
- License: LICENSE.md
Awesome Lists containing this project
README
---
output: github_document
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
library(ProTrackR) |>
suppressMessages()
data("mod.intro")
```
# ProTrackR
[](https://github.com/pepijn-devries/ProTrackR/actions/workflows/R-CMD-check.yaml)
[](https://pepijn-devries.r-universe.dev/ProTrackR)
[](https://CRAN.R-project.org/package=ProTrackR)
[ProTracker](https://en.wikipedia.org/wiki/Protracker) is music sequencer software
from the 1990s on the [Commodore Amiga](https://en.wikipedia.org/wiki/Amiga)
(see screenshot of version 2.3a on the right).
This R package is designed to read, process and play ProTracker module audio files.
## Installation
> Get CRAN version
```{r eval=FALSE}
install.packages("ProTrackR")
```
> Get development version from R-Universe
``` r
install.packages("ProTrackR", repos = c('https://pepijn-devries.r-universe.dev', 'https://cloud.r-project.org'))
```
## Usage
The package comes bundled with a tiny chiptune, which can easily be played like so:
```{r play_intro, eval=FALSE}
library(ProTrackR) |>
suppressMessages()
data("mod.intro")
playMod(mod.intro, verbose = FALSE)
```
There are plethora of module files available on-line as well. Below you can see how
you can download such a file. It also show how you can select an audio sample
(number 25) from the module and calculate its power spectrum:
```{r power_cyberride}
elekfunk <- read.module("https://api.modarchive.org/downloads.php?moduleid=41529#elektric_funk.mod")
spec <- elekfunk |>
PTSample(25) |>
waveform() |>
tuneR::powspec(wintime = 0.1, steptime = 0.001)
image(log10(spec), col = hcl.colors(100, palette = "Inferno"))
```
While we are at it, why not play it:
```{r play_cyberride, eval=FALSE}
playMod(elekfunk, verbose = FALSE)
```
## Package status and alternatives
This package is no longer actively developed. It will receive minimal attention and
only required updates for the latest CRAN policies. It is surpassed by the alternatives
listed below.
* [ProTrackR2](https://pepijn-devries.github.io/ProTrackR2/):
A complete rewrite in C and
C++ of the current package using the
[ProTracker clone](https://github.com/8bitbubsy/pt2-clone)
by Olav Sørensen. It has similar features as the current package but has
a better implementation of the tracker interpretation and is a lot faster.
* [openmpt](https://pepijn-devries.github.io/openmpt/):
An R port of [libopenmpt](https://lib.openmpt.org/libopenmpt/). It plays
and renders a wide range of tracker music files, but they cannot be edited.
## Further reading
For some further reading and inspiration please have a look at the following blog
articles:
* [Chiptunes in R (1)](https://r-coders-anonymous.blogspot.com/2015/09/protrackr-chiptunes-in-r-part-one.html)
* [Chiptunes in R (2)](https://r-coders-anonymous.blogspot.com/2015/11/protrackr-chiptunes-in-r-part-two.html)
* [Chiptunes in R (3)](https://r-coders-anonymous.blogspot.com/2016/11/protrackr-chiptunes-in-r-part-three.html)