---
name: "smtool"
section: "1"
platform: "linux"
package: "spectmorph-tools"
version: "0.6.1-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/smtool"
---

# smtool(1)

tool to show/change SpectMorph data from .sm/.smset files

## NAME

smtool - tool to show/change SpectMorph data from .sm/.smset files

## SYNOPSIS

**smtool** *\<sm\_file\>\|\<smset\_file\>* *\<command\>* \[ *\<command\_specific\_args\>* \]

## DESCRIPTION

**smtool** is a general purpose program that can perform operations on .sm/.smset files. Some of the operations extract data (like **size**), others modify data (like **auto-tune**). If a .smset file is given as argument, the operation is performed on the individual .sm files that are contained in the .smset file.

## OPTIONS

**smtool** options depend on the command used, the command specific arguments are listed below.

## COMMANDS

- **volume** *\<percent\>*

  Compute average energy of the audio data around *\<percent\>*.

- **fundamental-freq**

  Output fundamental frequency of the audio data.

- **mix-freq**

  Output mixing frequency (sample rate) of the audio data.

- **zero-values-at-start**

  Output zero-values-at-start property of the audio data.

- **attack**

  Output attack parameters of the audio data.

- **size**

  Output overview of the size in bytes of the different parts of the audio data.

- **loop-params**

  Output loop parameters of the audio data.

- **noise-params** *\<frame\_no\>*

  Output noise component of a frame of the audio data.

- **frame** *\<frame\_no\>*

  Show original samples and reconstructed samples for one frame of the audio data.

- **frame-params** *\<frame\_no\>*

  Show the freqencies/magnitudes of one frame of the audio data.

- **total-noise**

  Sum up all noise parameters of all frames of the audio data.

- **nan-test**

  Check all frame data contents for NaNs.

- **original-samples**

  Show original samples of the audio data.

- **freq** *\<freq\_min\>* *\<freq\_max\>*

  Show all frequency entries of the audio data in the specified range.

- **spectrum** *\<frame\_no\>*

  Compare original and reconstructed spectrum for a given frame.

- **auto-loop** *\<percent\>*

  Set a one frame loop that starts and ends at the same point (given by *\<percent\>*).

- **tail-loop**

  Loop audio data at the end using a one frame loop.

- **auto-tune**

  Tune instrument using the (40%..60%) data to extract the actual frequency.

- **tune-all-frames**

  Tune each frame of the instrument. This will discard minimal changes in frequency which are normal for most instruments, so it might sound artificial.

- **auto-volume** *\<percent\>*

  Normalize audio volume, using the volume around *\<percent\>* as reference.

- **auto-volume-from-loop**

  Normalize audio volume, using the volume of the looped part as reference.

## SEE ALSO

smenc.1 \<https://testbit.eu/wiki/Smenc.1\>, smplay.1 \<https://testbit.eu/wiki/Smplay.1\>