\documentclass{article}
\usepackage{html}
\renewcommand{\texttt}[1]{\HTMLcode[FACE="Latin Modern Mono"]{FONT}{#1}}
\begin{document}
\htmladdtonavigation{%
\htmladdnormallink{\htmladdimg[TITLE="Werner Icking Memorial Archive"]{WIMA_icon.png}}{../..}
}
\title{MusiXTeX and Related Software}
\author{ }
\date{}
\maketitle

\par\noindent\textbf{News:} \begin{itemize} 

%\item
%\htmladdimg[alt="new 2024-06-24" title="new 2024-06-24"]{./new.gif} 
%Bob Tennent has uploaded \htmladdnormallink{musixebgr.tex}{../musixtex/musixebgr.tex}
%which allows replacing default Computer-Modern text fonts by EBGaramond; you may need to 
%install the \texttt{ebgraramond} package.

\item
\htmladdimg[alt="new 2025-11-15" title="new 2025-11-15"]{./new.gif}
Bob Tennent has uploaded \htmladdnormallink{MusiXTeX version 1.41}{../musixtex/musixtex141.zip}.
This version corrects a minor problem in musixcls.tex.
 

%\item
%\htmladdnormallink{TeXLive 2024}{https://www.tug.org/texlive/} has been officially released.  
%The 2024 release provides musixtex (1.37) and pmx (3.00).
%Installing the latest release is recommended because 
%older releases no longer get updates.
%
%Compiled binaries are provided for many Unix-like platforms, including Linux and MacOSX, and for Windows
%(but Windows users 
%may find 
%\htmladdnormallink{MiKTeX}{https://miktex.org} 
%to be more convenient). 
%Check out \htmlref{installation instructions here}{texlive}.
%
%If you have enough disk space,
%TeXLive 2024 can be installed in parallel with one or more older versions,
%but most users should first uninstall 
%an existing active TeXLive as follows: 
%
%\texttt{tlmgr remove -all}
%
%This will not remove ``local'' or ``personal'' additions, provided you have not
%put them into the texmf-dist tree.
%
%
%
%\item
%Bob Tennent has developed a 
%\htmladdnormallink{package}{../musixtex/musixmtab.tex}
%for typesetting  ``modern'' tablature,
%in which notes are provided with (downward) stems and beams.
%This is now available as an extension library in 
%\htmladdnormallink{MusiXTeX 1.37}{../musixtex/musixtex137.zip}.
%
%\item
%Alan Munn has submitted the recorder-fingering package.   
%The recorder-fingering package provides support for generating fingering diagrams for baroque fingering recorders. Standard fingerings are provided for recorders in both C and F, along with methods
%to create and display alternate fingerings for trills, etc. 
%
%The package is available from CTAN, in TeXLive and in MiKTeX. 
%
%\item
%Don Simons has released 
%\htmladdnormallink{PMX version 3.00}{../pmx/pmx300.zip}. 
%This version provides an option to remove the limit of 9 on forced
%beams. A side benefit of selecting the option is that all
%beams are vectorized and 2-digit figured bass figures are allowed.
%
%An easy-to-install package with 
%a zipped \verb\texmf\ tree, Windows 
%executables and a \verb\tar.gz\ file which can 
%be processed on any Unix-like system with basic GNU tools and a C compiler
%is available 
%\htmladdnormallink{here}{../pmx/pmx-3.00.zip} and
%at \htmladdnormallink{CTAN}{http://mirrors.ctan.org/support/pmx.zip},
%and is
%available in MikTeX and in TeXLive 2023.
%Consult \verb\pmx-install.pdf\ for installation instructions.
%
%\item
%Bob Tennent has released 
%\htmladdnormallink{version 1.36 of MusiXTeX}{../musixtex/musixtex136.zip}.
%This supports accidentals for Turkish classical music (Makam), new thin accidentals,
%and thicker ledger lines and Postscript hairpins.  It is also necessary to
%update to release 2023-01-11 of the 
%\htmladdnormallink{MusiXTeX fonts package}{../musixtex/musixtex-fonts2023-01-11.tds.zip}.
%
%\item
%Bob Tennent has released a minor 
%\htmladdnormallink{update}{../mtx/mtx-0.63d.zip}
%of \texttt{m-tx} to correct an uninitialized-variable bug in a source file. The bug did not affect
%normal usage of \texttt{prepmx}.

%\item
%\htmladdnormallink{TeXLive 2022}{https://www.tug.org/texlive/} has been officially released.  
%The 2022 release provides musixtex (1.35), pmx (2.98a), M-Tx (0.63c),
%autosp (2021-01-07) and xml2pmx (2021-02-07).  Installing the latest release is recommended because 
%older releases no longer get updates.
%
%Compiled binaries are provided for many Unix-like platforms, including Linux and MacOSX, and for Windows
%(but Windows users 
%may find 
%\htmladdnormallink{MiKTeX}{https://miktex.org} 
%to be more convenient). 
%Check out \htmlref{installation instructions here}{texlive}.
%
%If you have enough disk space,
%TeXLive 2022 can be installed in parallel with one or more older versions,
%but most users should first uninstall 
%an existing active TeXLive as follows: 
%
%\texttt{tlmgr remove -all}
%
%This will not remove ``local'' or ``personal'' additions, provided you have not
%put them into the texmf-dist tree.

%\item
%Don Simons has released 
%\htmladdnormallink{PMX version 2.98a}{../pmx/pmx298a.zip}. 
%This release fixes beaming in 6/2 time and after a new-movement command.
%
%An easy-to-install package with 
%a zipped \verb\texmf\ tree, Windows 
%and OSX 
%executables and a \verb\tar.gz\ file which can 
%be processed on any Unix-like system with basic GNU tools and a C compiler
%is available 
%\htmladdnormallink{here}{../pmx/pmx-2.98a.zip},
%at \htmladdnormallink{CTAN}{http://mirrors.ctan.org/support/pmx.zip},
%in MikTeX and in TeXLive2022.
%Consult \verb\pmx-install.pdf\ for installation instructions.


%\item
%Bob Tennent has released
%\htmladdnormallink{version 1.35 of MusiXTeX}{../musixtex/musixtex135.zip}.
%This release includes a ``handwriting'' font from MuseScore and an extension library
%\texttt{musixjt.tex} to use this font for all textual elements of a score, as
%is traditional in jazz scores.

%\item
%Bob Tennent has released 
%\htmladdnormallink{version 1.34 of MusiXTeX}{../musixtex/musixtex134.zip}.
%This release includes a new extension library \texttt{musixftab.tex} which
%supports traditional French tablature using script letters rather than numerals to specify
%notes.  The \verb|\tabfnt| definitions in \texttt{musixtex.tex} have been revised 
%to allow re-definition in \texttt{musixftab.tex}. A mini-font file
%\texttt{frenchtab.pfb} and associated support files are included.
%
%\item
%Bob Tennent has released 
%\htmladdnormallink{version 1.33 of MusiXTeX}{../musixtex/musixtex133.zip}.
%This version improves on the tablature support: tablature notes are
%now in (Helvetica) bold, tablature notes below the staff now use slashes (/) rather
%than ledger lines, as is conventional in French tablature, and new commands
%are provided to generate notehead-less stems above a tablature staff to specify
%note duration.
%
%Update 2021-07-07:  \htmladdnormallink{Version 1.33a}{../musixtex/musixtex133a.zip}  
%has improved implementation of the
%tablature commands:  more than three "slashes" below the staff are now replaced by numbers,
%and duration notes above the staff now have tiny noteheads (without ledger lines).
%
%\item
%Bob Tennent has released a new version of
%the \htmladdnormallink{musixtex-fonts}{../musixtex/musixtex-fonts2021-06-07.tds.zip} package.
%The type1 fonts have been regenerated, correcting glyph widths that were inconsistent 
%with the tfm widths.

%\item
%\htmladdimg[alt="new 2021-05-16" title="new 2021-05-16"]{./new.gif} 
%Bob Tennent has released 
%\htmladdnormallink{version 1.32 of MusiXTeX}{../musixtex/musixtex132a.zip}.
%This version provides a new add-on package \texttt{musixvbm} by Hiroaki Morimoto to support vectorized beams and hairpins, and corrects
%two minor issues in \texttt{musixtex.tex}.

%\item
%\htmladdnormallink{TeXLive 2021}{https://www.tug.org/texlive/} has been officially released.  
%The 2021 release provides musixtex (1.31), pmx (2.94a 2021-01-28), M-Tx (0.63c),
%autosp (2021-01-07) and, for the first time, xml2pmx (2021-02-07).
%
%Compiled binaries are provided for many Unix-like platforms, including Linux and MacOSX, and for Windows
%(but Windows users 
%may find 
%\htmladdnormallink{MiKTeX}{https://miktex.org} 
%to be more convenient). 
%Check out \htmlref{installation instructions here}{texlive}.
%
%If your system has texlive-derived packages installed by a distribution package manager,
%you should remove these before installing texlive itself.
%
%If you have enough disk space,
%TeXLive 2021 can be installed in parallel with one or more older versions,
%but most users should first uninstall 
%an existing active TeXLive as follows: 
%
%\texttt{tlmgr remove -all}
%
%This will not remove ``local'' or ``personal'' additions, provided you have not
%put them into the texmf-dist tree.
%
%\item
%
%Bob Tennent has corrected a minor bug in the scor2prt program in pmx-2.94.zip
%and uploaded an archive 
%\htmladdnormallink{here}{../pmx/pmx-2.94a.zip}.
%
%
%\item
%Bob Tennent has released a 
%new version of
%\htmladdnormallink{xml2pmx}{../xml2pmx/xml2pmx.zip} based on version 16 of
%Dieter Gl\"otzel's 
%\htmladdnormallink{MusicXML-to-PMX}{../xml2pmx/XML2PMX_01222021.zip}
%converter.
%The package currently supports Windows, MacOS and Linux platforms. 
%Version 0.23 of the
%\texttt{musixtex.lua} script supports pre-preprocessing of MusicXML files.
%The package is also available in MiKTeX and from ctan.org and it will be provided in TeXLive-2021.
%
%\item
%Bob Tennent has released version 2021-01-07 of the 
%\htmladdnormallink{autosp}{../autosp} preprocessor.  
%\verb|\Cp| is allowed as an abbreviation for \verb|\Cpause|.


%\item
%Bob Tennent has released 
%\htmladdnormallink{version 1.31 of MusiXTeX}{../musixtex/musixtex131.zip}.
%This version incorporates definitions of \verb|\zzdoublebar|, \verb|\zzbar| and
%\verb|\zendpiece|.  The \verb|musixtex.lua| script supports pre-precessing of
%MusicXML files using \texttt{xml2pmx}.

%\item
%Bob Tennent has released a 
%\htmladdnormallink{package}{../xml2pmx/xml2pmx.zip} based on Dieter Gl\"otzel's MusicXML-to-PMX converter.
%The package currently supports Windows, MacOS and Linux platforms but it is hoped 
%additional platforms will be supported in the future. Version 0.23 of the
%\texttt{musixtex.lua} script supports pre-preprocessing of MusicXML files
%and is included in the package.  The package is also available from ctan.org.

%\item
%Dieter Gl\"otzel has released an updated version 
%of his MusicXML-to-PMX converter
%(currently for 
%\htmladdnormallink{Windows}{../xml2pmx/XML2PMX_Windows.zip} 
%and 
%\htmladdnormallink{Linux}{../xml2pmx/XML2PMX_Linux.zip} 
%only).  The main improvement is a cleaner input organization.

%\item
%\htmladdnormallink{TeXLive 2020}{https://www.tug.org/texlive/} has been officially released.  
%It is not possible to upgrade from an earlier version but 
%TeXLive 2020 can be installed in parallel with an older version.
%To uninstall an existing TeXLive: 
%
%\texttt{tlmgr remove -all}
%
%
%The 2020 release provides musixtex (1.30), pmx (2.94 2020-03-20), M-Tx (0.63c)
%and autosp (2019-12-22) for 16 platforms, including MacOSX and Windows
%(but Windows users 
%may find 
%\htmladdnormallink{MiKTeX}{https://miktex.org} 
%to be more convenient). 
%Check out \htmlref{installation instructions here}{texlive}.
%
%%\item
%%Bob Tennent has released 
%%\htmladdnormallink{version 1.30 of MusiXTeX}{../musixtex/musixtex130.zip}.
%%This version incorporates definitions of \verb|\zdoublebar|, \verb|\hbp| and
%%\verb|\hbpp|.  The \verb|musixtex.lua| script supports options \verb|-X|, 
%%\verb|-version|, \verb|--version|, \verb|-help| and \verb|--help|.
%It is available in MiKTeX and TeXlive-2020. 

%\item
%Don Simons has released 
%PMX version 2.94. 
%This release allows moving dots on main and chord note in 2-note tremolos,
%and adds definitions of \verb|\hbp| and \verb|\hbpp| to pmx.tex.  
%
%Note (2020-03-20): a bug in the spacing of accidentals has been corrected. 
%It is available in MiKTeX and TeXlive-2020, or 
%use the following: 
%
%An easy-to-install package with 
%a zipped \verb\texmf\ tree, OSX and Windows executables and a \verb\tar.gz\ file which can 
%be processed on any Unix-like system with basic GNU tools and a C compiler
%is available 
%\htmladdnormallink{here}{../pmx/pmx-2.94.zip}.
%and at \htmladdnormallink{CTAN}{http://mirrors.ctan.org/support/pmx.zip}.
%Consult \verb\pmx-install.pdf\ for installation instructions.


%\item
%Bob Tennent has released
%\htmladdnormallink{version 0.22}{../musixtex/musixtex.lua}
%of the \verb|musixtex.lua| script, adding a new \verb|-X|
%option to allow configuring the \verb|pmx| preprocessor, to make
%it easier to use a beta. The new option is documented
%\htmladdnormallink{here}{../musixtex/musixtex.pdf}.

%\item
%Don Simons has released a new PMX beta, 
%\htmladdnormallink{version 2.90}{../pmx/pmx290.zip}. It 
%supports the insertion of blank gaps in the
%middle or at the end of any system. The middle gap might be used to create a very short coda at
%the end of a system. The end gap leaves the system shorter than the others, and, like the middle
%gap, creates a space that could be used for text comments. See \texttt{BlankGaps.pdf} in the archive for details.

%\item
%Bob Tennent has released a minor 
%\htmladdnormallink{update}{../mtx/mtx-0.63c.zip}
%of \texttt{mtx.tex} 
%so that commands \texttt{mtxAllsf} and 
%\texttt{mtxHelvetica} will work as advertised.  Also a new command \texttt{mtxTimes} (to
%replace Computer Modern fonts by Times) is now supported.  
%Definitions of \texttt{BIGfont} and \texttt{Bigfont} in \texttt{mtxlatex.sty} 
%have been replaced. The documentation
%\texttt{mtxdoc} has been revised accordingly.
%This release is available in MiKTeX and TeXlive-2020. 


%\item
%Don Simons has released a new PMX beta, 
%\htmladdnormallink{version 2.87}{../pmx/pmx287.zip}. It allows
%staff-jumping beams to change multiplicity right before or after the staff
%jump. Consult sjb.pmx and sjb.pdf for further details.

%\item
%Bob Tennent has released 
%\htmladdnormallink{version 1.29 of MusiXTeX}{../musixtex/musixtex129.zip}.
%It incorporates support for tablature notation for fretted string instruments
%such as lute, guitar, banjo, mandolin, and so on, adapted from R.J. Gelten's
%\htmladdnormallink{tabdefs.tex}{../musixtex/add-ons/tabdefs.tex}.
%An example and documentation are in Section~18.10 of
%\htmladdnormallink{\verb|musixdoc.pdf|}{../musixtex/musixdoc.pdf}.
%A new option has been added to \verb|musixtex.lua| to allow configuring the Postscript
%processor at the command line. 

%\item
%Bob Tennent has released 
%\htmladdnormallink{MusiXTeX-1.28}{../musixtex/musixtex128.zip}.  
%This provides new commands for repeats \emph{within} a bar, optionally
%forced to be at the end of a system; documentation is provided in the archive.
%
%Bugfix: corrected definition of \verb|\C@Inter| for \verb|\nblines < 4|.

%\item
%\htmladdnormallink{TeXLive 2018}{https://www.tug.org/texlive/} has been released.  
%This can be installed in parallel with one or more older releases.
%The 2018 release provides musixtex (1.27), pmx (2.84), M-Tx (0.63)
%and autosp (2018-02-23) for over 20 platforms, including MacOSX. 

%\item
%Don Simons has released 
%\htmladdnormallink{PMX version 2.84}{../pmx/pmx284.zip}.  This package is available 
%in the MiKTeX update wizard.  
%An easy-to-install package with 
%a zipped \verb\texmf\ tree, OSX and Windows executables and a \verb\tar.gz\ file which can 
%be processed on any Unix-like system with basic GNU tools and a suitable C compiler
%is available 
%\htmladdnormallink{here}{../pmx/pmx-2.84.zip} and
%at
%\htmladdnormallink{CTAN}{http://mirrors.ctan.org/support/pmx.zip}.
%Consult \verb\pmx-install.pdf\ for installation instructions.
%
%Changes since 2.83:
%\begin{rawhtml}
%<ul>
%  <li>Bug fix: dots in chordal seconds.</li>
%  <li>Bug fix: Initialize ihornb for non-beamed, down xtup.</li>
%  <li>Bug fix when using "AT" with 2-note x3c rD.</li>
%</ul>
%\end{rawhtml}


%\item
%Dirk Laurie has released
%\htmladdnormallink{M-Tx version 0.63}{../mtx/M-Tx-0.63.zip}.  
%It is also available from
%\htmladdnormallink{Github}{https://github.com/dlaurie/M-Tx}.
%
%Main changes:
%\begin{enumerate}
%\item `Space` can put in optional extra space between title block and 
%    first stave.
%\item Multibar rest may appear after comment lines in its paragraph. (Thanks
%   to Christian Mondrup for finding the bug.)
%\item Spurious error message when using `][` corrected. (Thanks
%   to Christian Mondrup for finding the bug.)
%\item Pickup consisting of rests allowed with multibar rest. (Feature requested
%   by  Christian Mondrup.)
%\item Also recognizes `F` as doubling duration in multiplet. (Feature requested
%   by  Christian Mondrup.)
%\item No longer adds an undesired duration to rests in a multiplet.  (Thanks
%   to Christian Mondrup for finding the bug.)
%\end{enumerate}
%
%\htmladdnormallink{This}{../mtx/mtx-0.63a.zip} archive 
%includes a zipped \verb\texmf\ tree, OSX and Windows executables and a \verb\tar.gz\ file which can 
%be processed on any Unix-like system with basic GNU tools and either
%\verb|gcc| or \verb|fpc|.
%Consult \verb\mtx-install.pdf\ for installation instructions.

%\item
%Bob Tennent has released version 2017-12-26 of the 
%\htmladdnormallink{autosp}{../autosp} preprocessor.
%This supports the new features of MusiXTeX~1.27, allows for single-note
%xtuplets and handles restbars > 1 for xtuplets or appoggiaturas.
%
%The package also includes a new program \verb|tex2aspc| which 
%re-factors conventional MusiXTeX scores into input
%suitable for \verb|autosp| pre-processing by merging all the usual notes
%commands in a measure into a single \verb|\anotes| command.

%\item
%Bob Tennent has released 
%\htmladdnormallink{MusiXTeX version 1.27}{../musixtex/musixtex127.zip},
%which introduces several new features:
%\begin{itemize}
%\item \verb|\meterN|
%\item \verb|\xxtuplet|
%\item pointed half-notes \verb|\hap| \verb|\happ| analogous to \verb|\qap| \verb|\qapp|
%\item abbreviations \verb|\nqqb| \verb|\nqqh| \verb|\nqqqb| \verb|\nqqqh| and
%    synonyms \verb|\nqql| \verb|\nqqu| \verb|\nqqql| \verb|\nqqqu|
%\item \verb|\hbsk| analogous to \verb|\hsk|
%\item \verb|\bqsk| \verb|\bhsk| \verb|\btsk| analogous to \verb|\qsk| \verb|\hqsk| \verb|\tqsk|
%\end{itemize}
%and eliminates \verb|\ds@oup|.  For explanations of the new features,
%see the 
%\htmladdnormallink{manual}{../musixtex/musixdoc.pdf}.

%\item
%Don Simons has produced a 
%\htmladdnormallink{beta of pmx283}{../pmx/pmx283PRE.zip}.  
%Changes:
%\begin{itemize}
%\item
% Allow tuplets with all rests except one note, including 2-note F-tuplets;
%   force horizontal bracket in such cases.
%\item
% Fix beaming (or not) and number location for xtups with
%   multiple rests. Still some problems with number height but
%   can be band-aided with number height tweak option.
%\item
% Fix problems when changing to or from octave treble clef.
%\item
% Allow forced beam height and slope tweaks with 2-note tremolos
%\item
% Allow chordal note with 2-note tremolos, adding dots as needed.
%\end{itemize}
%Please test the new features and,
%if you have pmx scores,
%compile them with this version to check compatibility.

%\item
%Bob Tennent has released 
%\htmladdnormallink{MusiXTeX version 1.26}{../musixtex/musixtex126.zip}.
%The only changes are corrections for minor bugs in the implementation
%of \verb|\setinterstaff| that were causing Overfull hboxes.

%\item
%Dieter Gl\"otzel has released an updated version 
%of his MusicXML-to-PMX converter
%(currently for 
%\htmladdnormallink{Windows}{../xml2pmx/XML2PMX_Windows.zip} 
%and 
%\htmladdnormallink{Linux}{../xml2pmx/XML2PMX_LINUX.tar.gz} 
%only).  
%Changes:
%\begin{itemize}
%       \item  There are new command line fields: \texttt{options} and \texttt{maxbar}. 
%          \texttt{options} may contain one or several of the nine letters \texttt{xpdvalstg}
%          in arbitrary sequence in upper or lower case and without spaces.
%          \texttt{maxbar} is a limit on the number of bars to be processed. 
%          When maxbar = 0 then all bars will be processed.
%        \item  With option = \texttt{L}, Lyrics can be extracted and stored in a separate file: \texttt{songtext.txt}.
%        \item  Automatic detection of pickup.
%        \item Incomplete measures or voices are automatically filled with blind rests.
%\end{itemize}
%

%\item
%Hiroaki Morimoto has released version 
%\htmladdnormallink{0.54}{http://kuuku.no.coocan.jp/pub/musixtex/musixpss/musixpss-0.54.tar.gz} of the 
%\htmladdnormallink{musixpss}{http://kuuku.no.coocan.jp/pub/musixtex/musixpss/index-e.html} 
%package (described
%in musixdoc.pdf as "Type M Postscript slurs").  This new version conforms
%to the new specifications
%of dvipdfm(x) and pdfTeX since TeX Live 2016 concerning
%MetaPost-generated EPS files (*.mps).
%The appearances of generated slurs are the same.
%In case you have a too-old version of MetaPost that does not support outputtemplate,
%use version 0.53.






%\item
%Bob Tennent has released 
%\htmladdnormallink{MusiXTeX version 1.25}{../musixtex/musixtex125.zip}.
%
%Changes:
%\begin{itemize}
%  \item included dummy file tuplet.tex
%  \item defined \verb|\qap|, \verb|\qapp|, \verb|\tqsk|
%  \item added \verb|\ignorespaces| to \verb|musixltx.tex|.
%\end{itemize}

%\item
%Bob Tennent has released version 2017-07-14 of the 
%\htmladdnormallink{autosp}{../autosp} preprocessor.
%Global skips are now automatically inserted before accidentals
%on \emph{all} collective-coding notes, not just beamed notes. In some
%cases, this additional spacing may be unnecessary; automatic
%spacing is \emph{not} provided for any of the \emph{explicit} accidental commands \verb|\sh|,
%\verb|\fl|, \verb|\smallsh|, etc.

%\item
%Bob Tennent has released version 2017-06-21 of the 
%\htmladdnormallink{autosp}{../autosp} preprocessor.
%The preprocessor now supports the use of one to four successive commas in
%a collective-coding segment to generate the effect of a ``global'' skip
%\verb|\QQsk|, \verb|\HQsk|, \verb|\TQsk| or \verb|\Qsk|, respectively;
%these generate corresponding "local" skips \verb|\qqsk|, \verb|\hqsk|, \verb|\tqsk| or \verb|\qsk|,
%respectively, 
%in \textit{every} staff of the output scores, 
%which ensures that the staffs remain horizontally synchronized.
%Furthermore, global skips are \textit{automatically} inserted before \textit{accidentals}
%on beamed collective-coding notes.

%\item
%Bob Tennent has released version 2017-06-14 of the 
%\htmladdnormallink{autosp}{../autosp} preprocessor.
%The preprocessor now implements the effects of the
%\verb|\TransformNotes| macro from the \verb|musixtnt| package. (This is significant
%because the \verb|musixtnt| implementation of \verb|\TransformNotes| is
%incompatible with the \verb|musixlyr| extension library.)

%\item
%Don Simons has produced a 
%\htmladdnormallink{beta of pmx280}{../pmx/pmx280PRE.zip}.  
%The Preface of the manual summarizes the changes,
%the most significant being 2-note tremolos.
%Please test this new feature and,
%if you have pmx scores,
%compile them with this version to check compatibility.
  
%\item
%Bob Tennent has released 
%\htmladdnormallink{MusiXTeX version 1.24}{../musixtex/musixtex124.zip}.
%
%Changes:
%\begin{itemize}
%  \item corrected material on transposition in musixdoc manual
%  \item preserve changes to \verb|\transpose| in an hboxed tremolo command
%  \item test that musixtex.tex has already been loaded in some extensions: 
%  musixps, musixec, musixhv, musixplt, musixtmr, musixppff 
%  \item changed from \verb|\it| to \verb|\ppff| in several places
%  \item support new command \verb|\setinterstaff{n}{m}|
%  \item define \verb|\largenotesize|, \verb|\Largenotesize|
%  \item corrected typos \verb|\twtybf[g]| \verb|\svtbf[g]|
%\end{itemize}

%\item
%Dieter Gl\"otzel has released an updated version 
%of his MusicXML-to-PMX converter
%(currently for 
%\htmladdnormallink{Windows}{../xml2pmx/XML2PMX_Windows.zip} 
%and 
%\htmladdnormallink{Linux}{../xml2pmx/XML2PMX_LINUX.tar.gz} 
%only).  

%\item
%Don Simons has released 
%\htmladdnormallink{PMX version 2.76}{../pmx/pmx276.zip}.  This package is available 
%in the MiKTeX update wizard and an easy-to-install
%package
%with Windows and OSX binaries is available at 
%\htmladdnormallink{CTAN}{http://mirrors.ctan.org/support/pmx.zip}.
%
%
%Changes:
%\begin{rawhtml}
%<ul>
%  <li>Allow accented characters in lyrics.</li>
%  <li>Behind-the-scenes modifications to allow staff-crossing chords that 
%    are unbeamed or beamed, as illustrated in staffcrossall.pmx.</li>
%  <li>Modifications to allow accented characters in text strings in
%    lyrics, page headers, and text dynamics.</li>
%  <li>Bugfixes in unbeamed, dotted xtuplets.</li>
%  <li>Increased allowable length of text dynamic strings from 52 to 64 
%    characters.</li> 
%</ul> 
%\end{rawhtml}

%\item
%\htmladdnormallink{TeXLive 2016}{https://www.tug.org/texlive/} has been released.  
%This can be installed in parallel with one or more older releases.
%The 2016 release provides musixtex (1.22), pmx (2.74), M-Tx (0.62), musixtnt (2016-01-30)
%and autosp (2016-01-30) for over 20 platforms, including MacOSX 
%and Windows.

%\item
%Don Simons has released 
%\htmladdnormallink{PMX version 2.74}{../pmx/pmx274.zip}.  This is also
%now available at 
%\htmladdnormallink{CTAN}{http://mirrors.ctan.org/support/pmx.zip}
%with Windows and OSX binaries and a gzipped-tar archive for Unix-like systems.
%
%Changes:
%\begin{itemize}
%\item Enabled staff-crossing chords with single stems, as ordinary beams,
%and as
%beamed xtuplets.
%\item Allow \verb|\"| in lyrics string, for umlaut.
%\item Fix bug in scor2prt that was causing crashes when last line started
%with \verb|%|.
%\item Enable note option Lx to lengthen a stem by x \verb|\internotes|.
%\end{itemize}

%\item
%Releases of musixtex (1.22), pmx (2.74), M-Tx (0.62), musixtnt (2016-01-30)
%and autosp (2016-01-30) are now available from the archive and from
%\htmladdnormallink{CTAN}{http://www.ctan.org}. 

%\item
%\htmladdimg[alt="new 2016-02-08" title="new 2016-02-08"]{./new.gif} 
%Dirk Laurie has released
%\htmladdnormallink{M-Tx version 0.62}{../mtx/M-Tx-0.62.zip}.  It must be used with
%PMX version at least 2.72
%and
%\texttt{musixtex.tex} version at least 1.21.
%It is also available from
%\htmladdnormallink{Github}{https://github.com/dlaurie/M-Tx}.
%
%\item
%\htmladdimg[alt="new 2016-01-31" title="new 2016-01-31"]{./new.gif} 
%Bob Tennent has uploaded an updated 
%\htmladdnormallink{\verb\autosp\ }{http://icking-music-archive.org/software/autosp/}
%package.
%The updated \verb\autosp\ corrects two small bugs and uses modern
%H-rest notation for multi-bar rests.
%
%\item
%\htmladdimg[alt="new 2016-01-31" title="new 2016-01-31"]{./new.gif} 
%Don Simons has announced the availability of a beta version of
%\htmladdnormallink{PMX 2.73}{../pmx/pmx273.zip}.
%Thanks to Dirk Laurie, PMX can now handle lyrics directly, without
%having to
%use M-Tx as a pre-preprocessor.
%
%\item
%\htmladdimg[alt="new 2016-01-28" title="new 2016-01-28"]{./new.gif} 
%\htmladdnormallink{\texttt{musixtex.tex} version 1.21}{../musixtex/musixtex.tex}
%now supports commands for ``bracket'' notation for piano pedals. See the
%\htmladdnormallink{manual}{../musixtex/musixdoc.pdf} (Section 18.5) for
%documentation.


%\item
%Don Simons has released a beta of 
%\htmladdnormallink{PMX version 2.72}{../pmx/pmx272.zip}.  It must be used with
%the beta of 
%\htmladdnormallink{\texttt{musixtex.tex} version 1.21}{../musixtex/musixtex.tex}.
%
%Changes since 2.70 are as follows:
%\begin{itemize}
%\item Octave treble clef ("C8" command).
%\item In figured bass, apply vertical shift for remainder of line with option
%\verb|v[-]|(number) to the figure command
%\item Internal changes in multi-bar rests to accommodate changes in
%musixtex.tex.
%\item Slurs aligned with stem ends, postscript slurs only, option "v" on a slur
%command.
%\item Coda "oC".
%\item New, smaller segno "oG". Unlike "og", must enter on every staff, and
%may be
%repositioned just like a normal ornament.
%\item 
%Bugfix when arpeggios go from one voice to another in the same staff.
%\item
%Further tweaks in multibar rests.
%\item
%Tweaks in centered full-bar rests.
%\item
%Fix bug in clef changes for multi-staff instruments.
%\end{itemize}

%\item
%Dirk Laurie and Bob Tennent have released version 0.16 of the
%\verb|musixtex.lua| 
%\htmladdnormallink{script}{../musixtex/musixtex.lua}. In this version,
%the \verb|-q| option copies version information from the temporary
%file to the log file. For documentation of all the options, see
%\htmladdnormallink{this}{../musixtex/musixtex.pdf} file.
%
%\item
%Dirk Laurie has released 
%\htmladdnormallink{mtx-0.61}{../mtx/mtx-0.61.zip}.  
%
%Main changes:
%\begin{enumerate}
%\item  \verb\TeX\ preamble command for Type 2 TeX strings.
%\item  Assertions: Range, Bars.
%\item  User's Manual thoroughly revised.
%\item  Misnamed procedure \verb\tex3\ is now \verb\TeXtype2\.
%\item  Page and font macros are included in \verb\mtx.tex\.
%\end{enumerate}
%
%The archive includes documentation sources, a zipped \verb\texmf\ tree, OSX and Windows executables and a \verb\tar.gz\ file which can 
%be processed on any Unix-like system with the usual GNU tools.
%Consult \verb\mtx-install.pdf\ for installation instructions.
%
%The mtx-0.61 package has been uploaded to CTAN but likely won't be available in TeXLive or
%MiKTeX until 2016.
%
%Added 2015-12-16:  Some additional testing revealed a serious bug in \verb|prepmx|; the
%package has been corrected.

%\item
%Bob Tennent has released \htmladdnormallink{MusiXTeX version 1.20}{../musixtex/musixtex120.zip}.
%The commands for tremolos now allow for numerical note pitches.
%The package includes version 0.15 of the \verb|musixtex| script, which subsumes 
%\verb|m-tx| and \verb|pmx2pdf| and 
%supports a new \verb|-q| (quiet) option.
%\item
%\htmladdimg[alt="new 2015-12-03" title="new 2015-12-03"]{./new.gif} 
%Dirk Laurie and Bob Tennent have provided a substantially expanded 
%\htmladdnormallink{\texttt{musixtex.lua}}{../musixtex/musixtex.lua} 
%script which subsumes the specialized \verb|m-tx| and \verb|pmx2pdf| scripts 
%and automatically determines which preprocessor(s) to use, even if
%the filename argument does not have an extension.
%Given a basename, \verb|musixtex| searches for
%the earliest file in the \verb|mtx-pmx-tex| or \verb|autosp-tex| chain and regards
%that as the source file. It builds the others from there on (you can
%also stop early). 
%Extension \verb|.ltx| is also recognized, and automatically
%selects
%LaTeX processing.  Some new features: a \verb|musixtex.log|
%file is generated and a \verb|-q| option diverts screen messages to
%a temporary file. 
%Full details are in the
%\htmladdnormallink{documentation}{../musixtex/musixtex.pdf}.

%\item
%Don Simmons has revised \verb|pmx.tex| so that headings are the usual size
%when one of the non-standard font libraries (\texttt{musixtrm}, \texttt{musixplt}, \texttt{musixhv})
%is used.  It is available in
%\htmladdnormallink{this}{../pmx/pmx2704.zip}
%archive, which is otherwise identical to \verb|pmx270.zip|.
%\item
%Bob Tennent has released 
%\htmladdnormallink{MusiXTeX version 1.18}{../musixtex/musixtex118.zip}.

\end{itemize}
\par\noindent\textbf{Table of Contents:}
\tableofchildlinks*
\par\noindent\textbf{Archive:}
\begin{itemize}
\item 
\begin{rawhtml}
Experienced
users or those seeking an older file may wish to bypass this page and browse
the <a href="../">archive</a>. That is the only access to some older
versions of current software (many <a href="../musixtex/older-versions">past
versions of MusiXTeX</a>, useful for tracking changes), files for MusiXTeX's
historical predecessors <a href="../musictex">MusicTeX</a> and <a
href="../mutex">MuTeX</a>, and some other files that are not linked to from any
web pages.
\end{rawhtml}
\item  This web page as of December 2012 is available
\htmladdnormallink{here}{../indexmt6-2012-12.html}
\item Current 
\htmladdnormallink{source archive}{../wima.zip} for this web page. 
\end{itemize}
\par\noindent\textbf{Search the WIMA Software Archive:}
\label{search}
\begin{rawhtml}
<script>
  (function() {
    var cx = '011131570986801186527:mltelpht2vi';
    var gcse = document.createElement('script'); gcse.type = 'text/javascript'; gcse.async = true;
    gcse.src = (document.location.protocol == 'https:' ? 'https:' : 'http:') +
        '//www.google.com/cse/cse.js?cx=' + cx;
    var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(gcse, s);
  })();
</script>
<gcse:search></gcse:search>
\end{rawhtml}

\section{Introduction}
MusiXTeX, created by Daniel Taupin, Andreas Egler and Ross Mitchell, is software that uses a typesetting
system called TeX to typeset music. To use it, one produces
a text file describing the music to be typeset; then the software processes the input file
and eventually produces the typeset music as a PDF or other printable format. In fact,
MusiXTeX processing normally requires three passes: MusixTeX itself, followed by a program called MusiXflx,
followed by MusixTeX again; then, it is usually necessary to convert the resulting file to
a suitable format, such as Postscript or PDF.

To simplify the inputting of instrumental music, a pre-processor PMX by Don Simons can be used. Inputs to
PMX are considerably simpler than those for MusiXTeX itself because PMX makes many typesetting
decisions itself, and then produces a file suitable for processing by MusiXTeX. An auxiliary program
\texttt{scor2prt} in the PMX package makes parts from a multi-part score.  PMX can make a MIDI file
of your score.
For vocal music, a pre-preprocessor called M-Tx by Dirk Laurie is available; its output is suitable
for pre-processing by PMX.

The \texttt{autosp} pre-processor by Bob Tennent simplifies
input of music for MusiXTeX without requiring the user to learn
a completely different input language. MusiXTeX itself requires a user
to specify horizontal-spacing commands, which can be rather complicated,
especially for
multi-instrument scores. The \texttt{autosp} pre-processor automates
the generation of horizontal-spacing commands for MusiXTeX, allowing
a user to input notes for a part without
concern for note-spacing changes within the part or spacing requirements of other parts;
compare 
\htmladdnormallink{\texttt{quod.tex}}{../musixtex/quod.tex} and
\htmladdnormallink{\texttt{quod2.aspc}}{../autosp/doc/quod2.aspc}.

Finally there is a program \texttt{xml2pmx} that translates MusicXML, a standard exchange format, to
PMX. 
Most music notation-editing systems such as Finale, Sibelius, musescore and lilypond will
allow you to export a score in MusicXML format.

A 
\htmladdnormallink{script}{../musixtex/musixtex.lua} that automates 
use of these pre-processors and the multiple passes is available; for example, 
the single command 
\begin{itemize}{}{}\item[]
  \texttt{musixtex mymusic}
\end{itemize}
will process a file \texttt{mymusic.mtx} and produce \texttt{mymusic.pdf}, calling
in turn the M-Tx pre-processor \texttt{prepmx}, the PMX preprocessor \texttt{pmxab},
and the three passes of MusiXTeX itself; finally, 
the output is converted to PDF and intermediate files are deleted.
Usually, users need not know anything about the details.

It is possible to create inputs for MusiXTeX, PMX, M-Tx or autosp using any
text editor, such as \texttt{notepad} or \texttt{vi} or \texttt{emacs}. 
Currently there is no
graphical user interface for generating input files, other than
TeX-oriented
integrated graphical development environments such as TeXWorks. 

\subsection{Small Examples}
\label{examples}
\subsubsection{MusiXTeX}
\textbf{\emph{Quodlibet} by J. S. Bach (1685--1750)}\\
\begin{itemize}
\item input: \htmladdnormallink{\texttt{quod.tex}}{../musixtex/quod.tex}
\item output: \htmladdnormallink{\texttt{quod.pdf}}{../musixtex/quod.pdf}
\end{itemize}
\subsubsection{PMX}
\textbf{\emph{Adagio} by Francesco Barsanti (1690--1772)}\\
\begin{itemize}
\item input: \htmladdnormallink{\texttt{barsant.pmx}}{../pmx/barsant.pmx}
\item outputs: \htmladdnormallink{\texttt{barsant.tex}}{../pmx/barsant.tex},
\htmladdnormallink{\texttt{barsant.pdf}}{../pmx/barsant.pdf},
\htmladdnormallink{\texttt{barsant.mid}}{../pmx/barsant.mid}
\end{itemize}
\subsubsection{M-Tx}
\textbf{\emph{Net soos ek is}, English lyrics ("Just as I am") by Charlotte Elliott (1789--1871)}\\
\begin{itemize}
\item input: \htmladdnormallink{\texttt{netsoos.mtx}}{../mtx/netsoos.mtx}
\item outputs: \htmladdnormallink{\texttt{netsoos.pmx}}{../mtx/netsoos.pmx},
\htmladdnormallink{\texttt{netsoos.tex}}{../mtx/netsoos.tex},
\htmladdnormallink{\texttt{netsoos.pdf}}{../mtx/netsoos.pdf}
\end{itemize}%
\subsubsection{Autosp}
\textbf{\emph{Quodlibet} by J. S. Bach (1685--1750)}\\
\begin{itemize}
\item input: \htmladdnormallink{\texttt{quod2.aspc}}{../autosp/doc/quod2.aspc}
\item outputs: \htmladdnormallink{\texttt{quod2.tex}}{../autosp/doc/quod2.tex},
\htmladdnormallink{\texttt{quod2.pdf}}{../autosp/doc/quod2.pdf}
\end{itemize}%
\subsubsection{Xml2pmx}
\textbf{\emph{Fantasia 1 for Recorder} by G. P. Telemann (1681--1767)}\\
\begin{itemize}
\item input: \htmladdnormallink{\texttt{Telemanm.xml}}{../xml2pmx/Telemann.xml}
\item outputs: \htmladdnormallink{\texttt{Teleman.pmx}}{../xml2pmx/Telemann.pmx}, 
\htmladdnormallink{\texttt{Telemann.pdf}}{../xml2pmx/Telemann.pdf}
\end{itemize}%
\subsection{Primary Documentation for MusiXTeX, PMX, M-Tx, autosp, xml2pmx and the musixtex script}
\begin{itemize}
\item \htmladdnormallink{MusiXTeX}{../musixtex/musixdoc.pdf}, by
Daniel Taupin, Ross Mitchell, Andreas Egler,
Oliver Vogel, Don Simons, Andre van Ryckeghem, Cornelius Noack, Hiroaki Morimoto and Bob Tennent
\item \htmladdnormallink{MusiXTeX Reference Table}{../musixtex/musixre1.pdf} 
\item \htmladdnormallink{PMX Manual}{../pmx/pmx300.pdf}, by Don Simons
\item \htmladdnormallink{PMX Tutorial}{../pmx/pmxccn.pdf},  by Cornelius C. Noack
\item \htmladdnormallink{PMX Reference Table}{../pmx/ref300.pdf}, by Don Simons 
\item \htmladdnormallink{PMX Tips and Tricks}{../pmxtricks/tricks.html}, contributed by users
\item \htmladdnormallink{One-page PMX \emph{tour de force}}{../pmx/most.pdf}, showing most PMX commands, by Don Simons
\item \htmladdnormallink{M-Tx User's Guide}{../mtx/mtxdoc.pdf}, by Dirk Laurie
\item \htmladdnormallink{autosp manual}{../autosp/doc/autosp.pdf}, by Bob Tennent
\item \htmladdnormallink{xml2pmx manual}{../xml2pmx/xml2pmx.pdf}, by Bob Tennent and Dieter Gloetzel
\item \htmladdnormallink{musixtex script manual}{../musixtex/musixtex.pdf}, by Bob Tennent 
\end{itemize}
Additional and more specialized documentation is available
\htmlref{here}{addDocument}. 

\section{Getting Started: Four Scenarios}

\subsection{MiKTeX on Windows}

\subsubsection{Installing and/or Updating MiKTeX}
The most popular TeX distribution for Windows is 
\htmladdnormallink{MiKTeX}{http://miktex.org}.  If you already have the most recent version
of MiKTeX installed and fully updated,
you can skip down to \htmlref{here}{addMiKTeX}; otherwise, download
the current "basic" MiKTeX installer available 
\htmladdnormallink{here}{http://miktex.org/download}.
Download the version appropriate for your system: 32 bit or 64 bit.

When it has been fully downloaded, open the Downloads folder, double-click
on the basic-miktex icon, and click on the Run button. 

When the Copying Conditions window opens,
click on the "I accept the MiKTeX copying conditions" box and then click on the Next button.

You may then be asked if MiKTeX should be installed for all users or just for yourself.
When you've made your choice, click on the Next button.  If you chose to install
MiKTeX just for yourself, you'll have to choose a location; otherwise, a standard
system location is suggested.

In the Next window, you'll be asked to choose between A4 and letter-sized paper as the default,
and to specify whether you want missing packages installed fully automatically, after
asking you, or not at all. Automatic package installation is a nice feature of MiKTeX but it's
not foolproof.  If A4 is the paper size you mostly use, choose A4, \emph{not} "A4 (A4size)" as the default;
a4 is the Postscript PaperSize recognized by \texttt{ps2pdf}.

You can then start the installation process. It may take 10 to 15 minutes, depending on the
bandwidth of your internet connection.  When it finishes, click on Next and then Close.

You should now find entries for 
the MiKTeX Update wizard and for the MiKTeX Package Manager under MikTeX~2.9~$\longrightarrow$~Maintenance in the Start menu; if you have Administrator privileges and 
have installed MiKTeX system-wide, choose the (Admin) version of Maintenance. 
Click on
Update. The first window can usually be ignored; click on the Next
button and then wait for the available updates to be listed. If there
are available updates that are \emph{not} ticked, those will have to be
updated after the first round of updates. Click on the Next button and
wait till the initial update process terminates. Then repeat the entire
update process until there are no more updates available.

You are now ready to install the MusiXTeX-specific packages. Do not attempt to use
the \texttt{musixtex}, \texttt{pmx} or \texttt{m-tx} binaries installed by the MiKTeX installer 
at this point; they are not yet operational.


\subsubsection{Adding Packages to MiKTeX}
\label{addMiKTeX}

We assume you have MiKTeX installed and fully updated.  Find the 
relevant MiKTeX package manager in the Start menu; click on it.  A window listing thousands of MiKTeX package
opens.  Enter "musixtex" into the Name field and click on Filter. Click on Select All in the Edit menu
so that all packages are highlighted and click on the + sign (for "add"). Then repeat
this process as necessary for "pmx", "m-tx",  "autosp" and "xml2pmx" (selecting only packages not yet installed).  
You may need additional packages ("soul", "psnfss", "palatino", "fpl", "times", "helvetica" ) 
if your scores use features such as letter-spacing or non-standard fonts
(via extension libraries \texttt{musixplt}, \texttt{musixtmr} or \texttt{musixhv}).

You're now ready to typeset music.

\subsubsection{First Examples in MiKTeX}

Download the following example input files:
\htmladdnormallink{\texttt{quod.tex}}{../musixtex/quod.tex},
\htmladdnormallink{\texttt{barsant.pmx}}{../pmx/barsant.pmx},
\htmladdnormallink{\texttt{netsoos.mtx}}{../mtx/netsoos.mtx},
\htmladdnormallink{\texttt{quod2.aspc}}{../autosp/doc/quod2.aspc} and
\htmladdnormallink{\texttt{Telemann.xml}}{../xml2pmx/Telemann.xml},
and save in a new folder.
Click on the Command Prompt entry in the Accessories menu and move to your
new folder.  Then do
\begin{itemize}
\item[] \texttt{> musixtex quod}
\item[] \texttt{> musixtex barsant}
\item[] \texttt{> musixtex netsoos}
\item[] \texttt{> musixtex quod2}
\item[] \texttt{> musixtex Telemann}
\end{itemize}
or just \begin{itemize}
\item[] \texttt{> musixtex quod barsant netsoos quod2 Telemann}
\end{itemize}
The folder should now contain PDF files similar to the "outputs"  \htmlref{here}{examples};
you can use any PDF viewer to view them. (There will also be some log files and a midi version of \texttt{barsant}; the midi file can be played on a
media player such as the Windows Media Player.)  If the Adobe Reader is your
default PDF viewer, you may want to read \htmlref{this}{acroread} before you start to
edit documents.

\subsection{TeXLive on a Unix-like System (Linux, Solaris, BSD, etc.)}

\subsubsection{Installing and/or Updating TeXLive}
\label{texlive}

On Unix-like systems, the most popular TeX distribution is called 
\htmladdnormallink{TeXLive}{http://www.tug.org/texlive/}.
If your system uses a "package manager", you may want to check whether
TeXLive packages can be installed using it. 
If so, you should be able to install
at least \texttt{musixtex}, \texttt{pmx} and \texttt{m-tx} packages using the package manager.

Packages derived from TeXLive are now officially in recent versions of Fedora Linux
and  
Red Hat Enterprise Linux, but may date back to 2012.
Information on TeXLive packages for Debian-based distributions such as Ubuntu is available
\htmladdnormallink{here}{http://www.tug.org/texlive/debian.html}.
See 
\htmladdnormallink{this}{http://www.tug.org/texlive/distro.html} page
for other distributions.  


If you already have the most recent version of TeXLive installed and fully updated,
you can skip down to \htmlref{here}{addTeXLive}; otherwise,
to install TeXLive yourself, download the installer available
\htmladdnormallink{here}{http://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz}.
Unpack the archive:

\texttt{tar zxvf install-tl-unx.tar.gz} 

then move to the resulting \texttt{install-tl-...} directory and execute
the \texttt{install-tl} script, as root if you are installing for 
all users. 

First, verify that that the correct platform has been detected; if not, enter B and
select the correct one.  

Next, you should select an installation scheme.  A \emph{full} installation requires
over 3 GB of disk space and a massive download but for typesetting music, the "basic" scheme 
(supplemented by a few additional packages) will be fine. Customize the basic scheme
by selecting appropriate language collections (English, French, German, etc.).
It is possible to
have the music collection installed initially, but this can also be done after installation,
as described in detail
\htmlref{here}{addTeXLive}.

If you are installing a "private" TeXLive installation for yourself, you will have to
specify a writeable \texttt{TEXDIR} directory such as \texttt{\$HOME/texlive/2021}; if you have root privileges and are installing
for all users,  you can accept the default.

Finally, there are some options available, such as A4 or letter-size paper as the default.
You may want the installer to install symbolic links in standard directories;
in a personal installation you should use \texttt{\$HOME/bin} for binaries,
and accept the defaults for a system-wide installation. 

You can then start the installation itself.  When it finishes, add the relevant \texttt{bin} directory
to your \texttt{PATH} if symbolic links weren't added to 
\texttt{/usr/local/bin}. 
Any improperly
set environment variables should be corrected wherever they are set.   


The TeXLive installer will install the most recent packages available so it is not necessary to
update immediately after installing but the command to update any installed
packages is

\texttt{tlmgr update --self --all}

(executed as root for a system-wide installation),
or use the graphical interface invoked by \texttt{tlmgr -gui}.
For documentation of the most frequently used options of \texttt{tlmgr}, do

\texttt{texdoc tlmgr}

Note that \texttt{tlmgr} will not be available if you install texlive packages
using a package manager; you will have to use the package manager to update or install packages.





\subsubsection{Adding Packages to TeXLive}
\label{addTeXLive}
The packages needed for MusiXTeX, PMX, M-Tx, autosp and xml2pmx are all in the music-typesetting collection,
so the following command will suffice:

\texttt{tlmgr install collection-music}

(executed as root for a system-wide installation), or use the graphical
interface invoked by \texttt{tlmgr -gui}.  
You may need additional packages ("soul", "psnfss", "palatino", "fpl", "helvetica", "times") 
if your scores use features such as letter-spacing or non-standard fonts
(via extension libraries \texttt{musixplt}, \texttt{musixtmr} or \texttt{musixhv}).

\subsubsection{First Examples in TeXLive}
\label{typesetTeXLive}
Download the following example input files:
\htmladdnormallink{quod.tex}{../musixtex/quod.tex}, 
\htmladdnormallink{barsant.pmx}{../pmx/barsant.pmx},
\htmladdnormallink{netsoos.mtx}{../mtx/netsoos.mtx},
\htmladdnormallink{quod2.aspc}{../autosp/doc/quod2.aspc} and
\htmladdnormallink{Telemann.xml}{../xml2pmx/Telemann.xml},
and save in a new directory.
Start up a terminal and move to your
new directory.  Then do
\begin{itemize}
\item[] \texttt{\$ musixtex quod}
\item[] \texttt{\$ musixtex barsant}
\item[] \texttt{\$ musixtex netsoos}
\item[] \texttt{\$ musixtex quod2}
\item[] \texttt{\$ musixtex Telemann}
\end{itemize}
or just \begin{itemize}
\item[] \texttt{\$ musixtex quod barsant netsoos quod2 Telemann}
\end{itemize}
The folder should now contain PDF files similar to the "outputs"  \htmlref{here}{examples};
you can use any PDF viewer to view them. (There will also be some log files and a midi version of \texttt{barsant}; the midi file can be played on any
media player that supports that format, such as 
\htmladdnormallink{Rosegarden}{http://www.rosegardenmusic.com/} or 
\htmladdnormallink{TiMidity++}{http://timidity.sourceforge.net/}.)
If the Adobe Reader is your default PDF viewer, you may want to read
\htmlref{this}{acroread} before you start to edit documents.

\subsection{MacTeX (or BasicTeX and MacTeX-Additions) on a Mac}

A version of TeXLive especially suited to Macs (running Mac OS 10.5 or higher --- PPC or Intel) is called 
\htmladdnormallink{MacTeX}{http://www.tug.org/mactex/}. 
If you already have MacTeX installed and fully updated, you can 
just add the necessary packages in exactly the same ways as TeXLive,
as described \htmlref{here}{addTeXLive}; otherwise, either download
the 
\htmladdnormallink{full installation package}{http://mirror.ctan.org/systems/mac/mactex/MacTeX.pkg}
(2.1~G) or, if you want TeX just for music typesetting, download the
\htmladdnormallink{BasicTeX}{http://mirror.ctan.org/systems/mac/mactex/mactex-basic.pkg} package
(64~M) and the
\htmladdnormallink{MacTeX-Additions}{http://mirror.ctan.org/systems/mac/mactex/mactex-additions.pkg} 
package (257~M), and then install the Music-typesetting collection.


Double-click on the downloaded files to install.
When the installation finishes, open a Terminal 
and update all packages by executing

\texttt{tlmgr update --self --all}

(as root).  
Now, install MusiXTeX, PMX and M-Tx (and some other music-typesetting packages) as follows:

\texttt{tlmgr install collection-music}

You should now be able to typeset music; follow the same 
\htmlref{instructions}{typesetTeXLive} as with TeXLive, except be sure to rename the files
to remove any \texttt{.txt} extensions
added to the filenames by the downloader.

To configure TeXWorks as an editing and music-typesetting environment, follow 
the instructions in
\htmlref{Configuring TeXWorks}{configTeXWorks}.

\subsection{Adding CTAN Packages to an Existing TeX System}
\label{addCTAN}
If you already have a TeX system other than the most recent versions of 
MiKTeX or TeXLive installed and are unwilling or unable to replace it or upgrade it to
the current MiKTeX or TeXLive, 
you can download the following packages from 
\htmladdnormallink{CTAN}{http://www.ctan.org/} (the Comprehensive TeX Archive Network) 
and add them to your system: 
\htmladdnormallink{\texttt{musixtex}}{http://mirrors.ctan.org/macros/musixtex.zip}, 
\htmladdnormallink{\texttt{musixtex-fonts}}{http://mirrors.ctan.org/fonts/musixtex-fonts.zip}, 
\htmladdnormallink{\texttt{pmx}}{http://mirrors.ctan.org/support/pmx.zip}, 
\htmladdnormallink{\texttt{m-tx}}{http://mirrors.ctan.org/support/m-tx.zip},
\htmladdnormallink{\texttt{autosp}}{http://mirrors.ctan.org/support/autosp.zip};
each package has a detailed installation guide. 
Before installation you should read the material below on
\htmlref{Adding Non-Distribution Packages}{addNonDist}. 

\section{Beyond the Basics}
\label{BeyondBasics}

\subsection{Configuring TeXWorks, TeXnicCenter, TeXShop or TeXStudio}
\label{configTeXWorks}

Some users are uncomfortable with the command line.
\htmladdnormallink{Many}{http://en.wikipedia.org/wiki/Comparison_of_TeX_editors}
TeX-oriented "integrated development environments" are available combining an editor, a previewer,
and menus for various operations.  
\subsubsection{TeXWorks}
One of these development environments is 
\htmladdnormallink{TeXWorks}{http://www.tug.org/texworks/},
which is available in MiKTeX, TeXLive, MacTeX and BasicTeX.
Here we explain how to configure TeXWorks
to process
input files using the \texttt{musixtex} script. 

After starting TeXWorks, click on

Edit\ $\rightarrow$\  Preferences\ $\rightarrow$\  Typesetting

then click on + to add a new processing tool as follows:
\begin{description}
\item[Name:] \texttt{MusiXTeX} (or whatever you want)
\item[Program:] \texttt{musixtex}
\item[Arguments:] \texttt{\$fullname}
\end{description}
You can move this processor up the list of available processors by using the up-arrow button.

\subsubsection{TeXnicCenter}

\htmladdnormallink{TeXnicCenter}{http://www.texniccenter.org} is a TeX-oriented editor for
Windows.   To process files using the \texttt{musixtex} script,
click on

Build \ $\rightarrow$\ Define Output Profiles\ $\rightarrow$\ Add

and provide a profile name, such as \texttt{MusiXTeX => PDF}; use
\texttt{musixtex} as the (La)TeX compiler
and choose "Main file's full path without extension" as the command-line argument.
Click on "Do not use BibTeX" and "Do not use MakeIndex", and
click OK.

\subsubsection{TeXShop}
\htmladdnormallink{TeXShop}{http://pages.uoregon.edu/koch/texshop/} is available for OS-X and 
has similar capabilities; check out

TeXShop Help Menu\  $\rightarrow$\  TeXShop Help Panel\  $\rightarrow$\  Advanced Help \ $\rightarrow$\  Additional Typesetting Engines

\subsubsection{TeXStudio}

\htmladdnormallink{TeXStudio}{http://www.texstudio.org} is another development environment.  To configure
this application to use the \verb|musixtex| script, click on

Options \ $rightarrow$\  Configure TeXStudio \ $\rightarrow$\ Add

In the leftmost box, insert \verb|musixtex:musixtex|, and in the second box
insert \verb\musixtex % | txs:///view-pdf-internal\. Now click OK
and open a MusixTeX score. Compile and view it by clicking

Tools \ $\rightarrow$\ User \ $\rightarrow$\ \verb|1:musixtex|

Check out the User Manual to see how to add options to \verb|musixtex| or add another
User command.
 
\subsection{Problems with the Adobe PDF Reader}
\label{acroread}

On many systems, the Adobe Reader is the default PDF viewer.  But this application
does not re-load the display automatically if the pdf file changes and, on Windows,
the pdf file can't be overwritten while the Reader has it open. These properties make it difficult
to use while editing a music file.

There are several
ways to avoid these problems.  One approach on Windows
is to 
use the \texttt{pdfopen}/\texttt{pdfclose} applications
available in MiKTeX 
with the Adobe Reader, as follows:
\begin{verbatim}
(process a source file) 
> pdfopen --file file.pdf
(edit the source file)
> pdfclose --file file.pdf
(process the source file) 
> pdfopen --file file.pdf
(edit the source file)
  :
\end{verbatim}
Note that you can only use \texttt{pdfclose} on a file that has
been opened with \texttt{pdfopen}.  The \texttt{pdfopen}/\texttt{pdfclose} applications
in (the non-Windows versions of) TeXLive differ from those in MiKTeX.

Another approach is to use
(while editing)
a PDF viewer that allows the file to be 
overwritten and re-loads automatically when that happens. 
Here are some recommended
applications.  

On Windows:
\begin{itemize}
\item \htmladdnormallink{SumatraPDF}{http://blog.kowalczyk.info/software/sumatrapdf/free-pdf-reader.html}
\item \htmladdnormallink{GSview}{http://pages.cs.wisc.edu/~ghost/gsview/}.  Note that
\htmladdnormallink{ghostscript}{http://www.ghostscript.com/download/gsdnld.html} 
must be installed first.  GSview is free to use but a "registration" nag message will be displayed
when you open it.  
\end{itemize}

On Mac OS-X: Preview, which is the default PDF viewer on OS-X (but check out
\htmladdnormallink{this}{http://duff-johnson.com/2014/04/07/apples-preview-still-not-safe-for-work/} 
warning)

On Linux:
\begin{itemize}
\item evince 
\item okular
\item zathura
\item qpdfview
\item xpdf
\item gv (ghostview)
\end{itemize}
Any of these can normally be installed using your distribution's package manager. 

Finally there are several TeX-oriented editing environments (such as
TeXWorks, available in TeXLive, MiKTeX and MacTeX, or 
\htmladdnormallink{TeXShop}{http://pages.uoregon.edu/koch/texshop/}, for MacTeX) which 
have an \emph{integrated} PDF viewer
and can be \htmlref{configured}{configTeXWorks} 
to use the \texttt{musixtex} script as the TeX 
processor.

\subsection{Adding Non-Distribution Packages}
\label{addNonDist}


\subsubsection{Texmf Files}
\label{texmf}

Normally, packages are updated or added to MiKTeX or TeXLive or to a Linux distribution by using the
distribution's update or package manager, as discussed above.  But if you want to add a package or an update that isn't
(yet or any longer) in your distribution, such as one of the 
\htmlref{addon}{addons} or \htmlref{beta}{betas} packages described below
or packages from 
\htmladdnormallink{CTAN}{http://www.ctan.org/} (the Comprehensive TeX Archive Network), you should
set up and use a "personal" \texttt{texmf} tree; do
not modify or add to
the distribution tree, which will confuse the package manager and may lead to instability.
Normally, files in a personal \texttt{texmf} tree (or in a working directory) have precedence over files in the
distribution
tree.

Detailed instructions for setting up a personal \texttt{texmf} tree in MiKTeX can be found
in 
\htmladdnormallink{Integrating Local Additions}{http://docs.miktex.org/2.9/manual/localadditions.html} in Chapter~4 of the 
\htmladdnormallink{MiKTeX manual}{http://docs.miktex.org/2.9/manual/}. 
Essentially, you create a new folder somewhere (even on your desktop),
and populate it with subfolders and files following the TDS standards (discussed below).
Then add the path to the new folder in the Roots option of the MiKTeX Settings wizard.
Note that if you have admin privileges on your system, there will be both an Admin
Settings and a User Settings wizard; use the former to make the added files accessible to all
users. Update the File-Name Database (FNDB) in the Settings wizard after adding files to
a personal or local texmf tree.


In TeXLive, personal additions are by default expected to be
under \texttt{\$HOME/texmf}; after any changes to this tree, execute
\texttt{texhash \$HOME/texmf} to update the data base of file names.

In MacTeX, \texttt{\$HOME/Library/texmf/} is by default a user's personal \texttt{texmf} tree.
On Lion and Mountain Lion, 
the \texttt{\$HOME/Library} folder is hidden; to open it, use the Finder's Go menu and hold down the Option key 
to reveal an extra item in the menu. 


On all platforms, it is important to put files into suitable sub-directories, as specified in
the 
\htmladdnormallink{TDS}{http://tug.org/tds/tds.html} (TeX Directory Standard); the following is
a summary of the most relevant paths:
\begin{description}
\item[TeX macros:] {\it\texttt{texmf}}\texttt{/tex/generic/}{\it\texttt{package-name}}\texttt{/}
\item[LaTeX macros and sty (style) files:] {\it\texttt{texmf}}\texttt{/tex/latex/}{\it\texttt{package-name}}\texttt{/}
\item[scripts:] {\it\texttt{texmf}}\texttt{/scripts/}{\it\texttt{package-name}}\texttt{/}
\item[documentation:] {\it\texttt{texmf}}\texttt{/doc/generic/}{\it\texttt{package-name}}\texttt{/}
\item[sources:] {\it\texttt{texmf}}\texttt{/source/.../}{\it\texttt{package-name}}\texttt{/}
\item[fonts]
\begin{itemize}
\item \texttt{mf} (Metafont source) files:
{\it\texttt{texmf}}\texttt{/fonts/mf/public/}{\it\texttt{package-name}}\texttt{/}
\item \texttt{tfm} (Tex font metric) files:
{\it\texttt{texmf}}\texttt{/fonts/tfm/public/}{\it\texttt{package-name}}\texttt{/}
\item \texttt{vf} (virtual font) files:
{\it\texttt{texmf}}\texttt{/fonts/vf/public/}{\it\texttt{package-name}}\texttt{/}
\item \texttt{pfb} (Type 1 font) files:
{\it\texttt{texmf}}\texttt{/fonts/type1/public/}{\it\texttt{package-name}}\texttt{/}
\item \texttt{enc} (font encoding) files:
{\it\texttt{texmf}}\texttt{/fonts/enc/dvips/}{\it\texttt{package-name}}\texttt{/}
\item \texttt{map} (font-map) files:
{\it\texttt{texmf}}\texttt{/fonts/map/dvips/}{\it\texttt{package-name}}\texttt{/}
\item \texttt{fd} (font-definition) files:
{\it\texttt{texmf}}\texttt{/tex/latex/}{\it\texttt{package-name}}\texttt{/}
\end{itemize}
\end{description}
where {\it\texttt{texmf}} is the path to the root of the \texttt{texmf} tree and {\it\texttt{package-name}} is the name of the package;
for Windows, replace \texttt{/} by \verb|\|.
Consistent use of {\it\texttt{package-name}} directories, as above, makes it
easier to find and
uninstall all the files of a package. 
For more information,
check out 
\htmladdnormallink{A Directory Structure for TeX Files}{http://tug.org/tds/tds.html}.

Executables (other than platform-independent scripts) do not appear in \texttt{texmf}
trees; distributions deal with executables in different ways.  If the package
provides an executable suitable for your platform, you must move it
to a directory on the PATH of executables; otherwise, you may need
to first compile the program from source files extracted from an archive,
typically doing
\verb|./configure && make && sudo make install|.


\subsubsection{Font Maps}
\label{fontmaps}

If you have added new fonts to your personal \texttt{texmf} tree, 
it may be necessary to enable the relevant font-map file.
\begin{itemize}
\item For MiKTeX, 
open a command-prompt window and do

\texttt{ initexmf ----edit-config-file updmap}

which will open a Notepad window on the relevant configuration file.  For each new font map file
\texttt{xyz.map}, 
add a line

\texttt{Map xyz.map}

(or \texttt{MixedMap xyz.map} if both Metafont and Type1 formats are available);
save the file and exit Notepad.  Then do

\texttt{initexmf ----mkmaps}

which will rebuild all the font-map files.  

You can add the \texttt{----admin} option to these commands if you want to update the font maps for all users, but then
you must open the command-prompt window as Admin (\emph{right-click} on the item in the
Programs menu).

\item
For TeXLive, execute

\texttt{ updmap ----enable Map=}{\it\texttt{map-file}}

or, for fonts such as the \texttt{musixtex} fonts that are available in both Type~1 and Metafont formats,

\texttt{ updmap ----enable MixedMap=}{\it\texttt{map-file}}

You should also run \texttt{updmap} (with no arguments) after TeXLive system fonts have been added or updated.

\item
For MacTeX, see
\htmladdnormallink{Installing TeX fonts}{http://tug.org/fonts/fontinstall.html}
and
\htmladdnormallink{Installing personal TeX fonts}{http://tug.org/fonts/fontinstall-personal.html}.

\item
For other distributions, you may have to read the relevant documentation.
\end{itemize}


On all platforms, the command \texttt{kpsewhich} can be used to see where any TeX-related file
is located;  for example, 

\texttt{kpsewhich psfonts.map} 

will tell you where the currently "active" map for Type 1 fonts is.
You can check that the relevant lines have been added,
but do not edit \texttt{psfonts.map} directly because
your modifications will be overwritten when you install new packages.

\subsection{Documentation for MiKTeX, TeXLive, BasicTeX and TeXWorks}
\begin{itemize}
\item \htmladdnormallink{MikTeX 2.9 Manual}{http://docs.miktex.org/2.9/manual/}, by Christian Schenk
\item \htmladdnormallink{MikTeX 2.9 FAQ}{http://docs.miktex.org/faq/}, by Christian Schenk
\item \htmladdnormallink{TeX Live Guide}{http://www.tug.org/texlive/doc/texlive-en/texlive-en.pdf}, edited by Karl Berry
\item \htmladdnormallink{About BasicTeX}{http://pages.uoregon.edu/koch/BasicTeX.pdf}, by Richard Koch
\item \htmladdnormallink{TeXWorks Manual}{http://texworks.googlecode.com/files/TeXworks-manual-r1029.pdf}, by Alain Delmotte, Stefan L\"offler, and others

\end{itemize}
\subsection{Add-ons}
\label{addons}
\subsubsection{Macros}
\begin{rawhtml}
<ul>
  <li>Postscript Slur Package M (Ver 0.54, 12 August 2017)
  by Hiroaki Morimoto. The package requires MetaPost. It will work with
  DVI viewers and dvipdfm. PMX does not expressly support it but does
  support MusiXTeX font-based slurs, with which this package should be
  compatible.
    <ul>
      <li><a
        href="http://kuuku.no.coocan.jp/pub/musixtex/musixpss/index-e.html">Link</a>
        to examples and setup instructions in English.</li>
       <li>Direct link to <a 
        href="http://kuuku.no.coocan.jp/pub/musixtex/musixpss/musixpss-0.54.tar.gz">
        Tarball</a>. Windows users
        may need to right click and "save target as", then open it locally
        with Winzip or equivalent, as it doesn't seem to open
        directly thru IE and Winzip when left-clicking.</li>
    </ul>
  <li>musixser (Ver 1.2) (<a
    href="../musixtex/add-ons/musixser12.zip">zip</a>, <a
    href="../musixtex/add-ons/musixser12.tgz">tgz</a>, <a
    href="../musixtex/add-ons/musixser12.readme">README</a>), a MusiXTeX
    extension package for voice-wise entry of music, by <a
    href="../../email-addresses.html" target="_blank">Rainer Dunker <img
    src="../../mail.gif" border="0" title="mail" alt="mail"></a></li>
  <li>musixlyr (Ver 2.1c, 12 June 03) (<a
    href="../musixtex/add-ons/musixlyr21c.zip">zip</a>, <a
    href="../musixtex/add-ons/musixlyr21c.tgz">tgz</a>, <a
    href="../musixtex/add-ons/musixlyr21c.readme">README</a>) a MusiXTeX
    extension package for lyrics handling, by <a
    href="../../email-addresses.html" target="_blank">Rainer Dunker <img
    src="../../mail.gif" border="0" title="mail" alt="mail"></a></li>
  <li><a href="../musixtex/add-ons/gd/ablauf.html">German description</a>
    how to create a <a
    href="../musixtex/add-ons/gd/gd.ps.gz"><i>Gottesdienstordnung</i></a> using
    LaTeX, M-Tx, PMX, MusiXTeX and musixlyr with complete <a
    href="../musixtex/add-ons/gd/gd.zip">source</a> provided by <a
    href="mailto:dirk@baack-lamstedt.de?subject=Gottesdienstordnung">Dirk Baack</a></li>
  <li>a <a href="../musixtex/add-ons/hld2mtex">package</a> used to typeset
    <a
    href="../musixtex/add-ons/hld2mtex/examples/o-pastor1.gif">music</a>
    by Hildegard von Bingen incl. TeX-font containing Hildegard's
    neumes.</li>
  <li>MusiXTeX extensions for <a
    href="../musixtex/add-ons/tabdefs.tex">tabulature</a>-notation with
    example (<a href="../musixtex/add-ons/tabxampl.tex">TeX-source</a>, <a
    href="../musixtex/add-ons/tabxampl.ps.gz">PS-file</a>) by <a
    href="mailto:gelten@wish.net">Ronald Gelten</a></li>
  <li>TTRM (Ver 3.0), a package by <a
    href="mailto:alexandros.droseltis@berlin.de">Alexandros
    Droseltis</a> to generate a MusiXTeX file for a row matrix (48
    forms) starting from a single row. Additional options generate the
    square matrix and the stravinskian rotation arrays ("verticals").
    <a href="../musixtex/add-ons/ttrm-3.0.tgz">Tarball</a>, <a
    href="../musixtex/add-ons/TTRM_README">info</a>, <a
    href="../musixtex/add-ons/manual.html">manual.</a></li>
  <li>MusiXTeX macros by <a href="mailto:moriwaki@mab.jpn.org">Moriwaki
    Michio</a>. <a href="../musixtex/add-ons/musixexp.zip">General
    Expansion Macros</a>, <a href="../musixtex/add-ons/musixwmn.zip">White
    Mensural Notation Macros</a>, <a
    href="../musixtex/add-ons/mxtx2mml.zip">MIDI Auto Generating
    Macros</a>. For more information follow this <a
    href="http://www.mab.jpn.org/musictex/musixtex_e.html#MusiXExp">link</a>.</li>
  <li><a href="../musixtex/add-ons/musixdbr.tex">musixdbr.tex</a>. This
    macro package by Rainer Dunker provides commands for dashed and
    dotted barlines. Being an enhanced variant of musixbar.tex, it
    supports individual barline settings per instrument and
    inter-instrument space, multi-staff instruments, different numbers
    of lines per staff, and individual \setsize settings. Dashing and
    dotting style may be changed by redefining \barlinedash or
    \barlinedots, respectively. See the included example code about how
    to make use of the different commands.</li>
  <li><a href="../musixtex/add-ons/musixcrd.tgz">musixcrd</a>, a package
    for typesetting jazz chord symbols by Robert Hennig.
    This package is distributed with the MusiXTeX package.
  </li>
  <li>
    <a href="../pmxchords">pmxchords</a> is a package 
    by <a href="mailto:fafejtao@gmail.com">Ondrej Fafejta</a> which allows chord symbols
    to be typeset above notes. The user adds macro calls to a pmx file. Key transposition is 
    supported by a pre-processing script.
  <li> 
    <a href="http://www-leland.stanford.edu/~wrinnes/bagpipe.tex/">bagpipe.tex</a> is
    a macro package that supports typesetting of bagpipe music. It has been updated
    to use MusiXTeX by default and is now available at CTAN.
  <li>
    <a href="http://www.ctan.org/pkg/harmony">harmony</a> is a LaTeX2e package for typesetting
    harmony symbols etc. in musicological texts.
  <li>
    <a href="../musixtex/musixplt.tex">musixplt</a> is a MusiXTeX extension library
    that replaces the default Computer Modern text fonts by Palatino-based fonts.
</ul>
\end{rawhtml}%
\begin{itemize}
\item 
Don Simons has provided a \texttt{musixjazz}  
\htmladdnormallink{package}{../musixjazz/musixjazz.zip} which supports typesetting scores
that look like a jazz fake book.
To install, you can \emph{either} 
install the files in the \texttt{tex}, \texttt{type1}, \texttt{tfm},
\texttt{map} and \texttt{doc} directories into a personal or
local \texttt{texmf} tree, as described in 
\htmlref{Adding Non-Distribution Packages, Texmf Files}{texmf}, 
\emph{or}
just unzip 
\htmladdnormallink{this}{../musixjazz/musixjazz.tds.zip} archive
at the root of a personal or local \texttt{texmf} tree.
After refreshing the file-name database, 
you must enable the font-map file \texttt{musixjazz.map} as described in
\htmlref{Adding Non-Distribution Packages, Font Maps}{fontmaps}.
\end{itemize}

\subsubsection{Documentation}
\label{addDocument}
\begin{rawhtml}
<ul>
  <li>Repository of music-notation mistakes in 
    <a href="../musixtex/add-ons/sottigra.pdf">French</a>,
    <a href="../musixtex/add-ons/sottiger.pdf">German</a> and
    <a href="../musixtex/add-ons/sottieng.pdf">English</a>,
    by <a href="mailto:coulon@obs-nice.fr">Jean-Pierre Coulon</a>.
    The source files are included in the musixtex packages.</li>

  <li> list of
  <a href="../pmx/pmx25-274.html">changes</a> to PMX since version 2.5.</li>

  <li>4-page example of typesetting <a
    href="../musixtex/add-ons/partitur.ps.gz">orchestral scores</a> with
    MusiXTeX-<a href="../musixtex/add-ons/partitur.tex">source</a></li>
  <li>1-page text on the combination of PMX with LaTeX2e by Eric
    Petersen - <a href="../musixtex/add-ons/pmx-l2e.pdf">PDF</a>, <a
    href="../musixtex/add-ons/pmx-l2e.tex">TeX source</a></li>
  <li>1-page text on typesetting rests by Werner Icking - <a
    href="../musixtex/add-ons/rests.pdf">PDF</a>, <a
    href="../musixtex/add-ons/rests.tex">TeX source</a></li>
  <li>2-page example on typesetting scales using \relativeaccid, by
    Werner Icking - <a href="../musixtex/add-ons/scale.pdf">PDF</a> , <a
    href="../musixtex/add-ons/scale.gif">GIF</a> ,  <a
    href="../musixtex/add-ons/scale.tex">TeX source</a> .</li>
  <li>4-page text on <a
    href="../musixtex/add-ons/Tabulature.ps.gz">tabulature</a> by <a
    href="mailto:michel.caprace@advalvas.be">Michel Caprace</a></li>
  <li>Illustrated and expanded PMX tutorials (PDF's) in <a
    href="../pmx/lcgpmx.pdf">Italian</a> with <a
    href="../pmx/lcgpmx.zip">sources</a> (Rev. 3, 20 Feb 2010),  <a
    href="../pmx/lcgpmxfr.pdf">French</a>, <a
    and href="../pmx/notdr.pdf">German</a>, 
    The Italian manual, created
    by Luigi Cataldi, is enhanced with many typeset examples, plus
    software installation instructions and an intro to M-Tx. The
    French, and German
    manuals are translations of the Italian
    one by Olivier Vogel and Christof Biebricher,
    respectively.  The 
    <a href="../pmx/pmxccn.pdf">English translation</a> (with many updates) by Cornelius C. Noack is referenced 
    under <a href="Introduction.html#SECTION00012000000000000000">Primary Documentation</a> above.
</ul>
\end{rawhtml}

\subsubsection{Fonts}
\begin{rawhtml}
<ul>
    <li><a href="../musixtex/add-ons/old-feta.tar.gz">Old-feta fonts</a>
      (both type1 and type3), <a
      href="../musixtex/add-ons/readme-of.txt">info</a> . These are
      primarily for mensural notation.</li>
    <li><a href="../musixtex/lute-tex.zip">Lute tablature fonts</a> Version 1.01,
      by Wayne Cripps, with type1 versions by Takanori Uchiyama.
      <a href="../musixtex/readme-lute.txt">Contents of zip</a>, <a
      href="../musixtex/readme-lute-ps.txt">Info</a> for type1
      versions, <a href="../musixtex/lute9.pdf">example</a>. Non-commercial use
      only, with attribution to Wayne Cripps and referral to the 
      <a  href="http://www.cs.dartmouth.edu/~wbc/lute/AboutTab.html">Tab</a> website required.</li>

    <li><a href="../musixtex/add-ons/figbas.zip">figbas</a> (Ver 1.0.1,  
    10 January 2011), fonts for
    special figured-bass ligatures for 2+, 4+, 5+, 6+, and 9+, by Bob Tennent. This
    is available as a package in TeXLive and MiKTeX.</li>
</ul>
\end{rawhtml}

\subsubsection{Binaries and Scripts}
\label{addBin}
\begin{rawhtml}
<ul>
<li>
The 
<tt>musixtex</tt> script included
from version 1.20 of the <a href="../musixtex/musixtex120.zip">MusiXTeX</a> package
subsumes scripts <tt>m-tx</tt> and <tt>pmx2pdf</tt> used formerly with M-Tx and PMX files;
it is also available separately
<a href=""../musixtex/musixtex.lua">here</a>.
<li>A sample <a href="../pmxtricks/runpmx.bat">batch script</a> for running PMX (on Windows only);
you may have to edit the paths to suit your installation.  
  <li>DOS/Win binaries for <a
    href="../musixtex/add-ons/dvitools.zip">dvidvi, dviconca,
    dviselec</a>. These handy tools let you rearrange pages in
    dvifiles, for example to make a booklet. The DOS/Win binaries can
    be hard to find.</li>
  <li><a href="../mtx/mtxutil.zip">mtxutil</a>, M-Tx utilities written in
    Perl to extract voices (<a href="../mtx/exmtx.readme">info</a>) or to
    transpose (<a href="../mtx/trmtx.readme">info</a>).</li>

</ul>
\end{rawhtml}
\begin{itemize}
\label{musixtnt}
\item Bob Tennent has uploaded an
\htmladdnormallink{archive}{../musixtnt/musixtnt.zip}
containing a MusiXTeX extension library  \texttt{musixtnt.tex} and C source code, binaries for Windows (32 bit and
64 bit) and MacOSX, and documentation for a program
\texttt{msxlint}. This will be of interest to music
typesetters who use MusiXTeX directly, rather than via
pre-processors PMX or M-Tx.
\item
Bob Tennent has provided an \texttt{autosp} 
\htmladdnormallink{package}{../autosp/autosp.zip}; \texttt{autosp} is a new preprocessor that 
generates note-spacing commands for  
MusiXTeX scores.  For more information, see the 
\htmladdnormallink{README}{../autosp/README}.
Now included in the package is a small utility (rebar) that
reads a MusiXTeX source from standard input
and generates a copy to standard output with correct
bar-number comments of the form \%barno appended to \verb|\bar|, \verb|\alaligne|, etc.

\item
\htmladdimg[alt="new 2016-04-01" title="new 2016-04-01"]{./new.gif} 
Dieter Gl\"otzel has released version 1.0
\htmladdnormallink{}{../xml2pmx/XML2PMX_Windows.zip} 
of his MusicXML-to-PMX converter
(currently for 
\htmladdnormallink{Windows}{../xml2pmx/XML2PMX_Windows.zip} 
and 
\htmladdnormallink{Linux}{../xml2pmx/XML2PMX_LINUX.tar.gz} 
only).  


\end{itemize}

\subsection{Betas}
\label{betas}
A beta program or version is software that is released for testing by the developers
but has not yet been deemed "stable" (ready for general use).  Software referenced here
is not for novices nor for "production" use. 
Bugs are to be expected and should be reported to the developers.
\begin{itemize}
%\item
%\htmladdimg[alt="new 2023-07-18" title="new 2023-07-18"]{./new.gif} 
%Bob Tennent has developed a 
%\htmladdnormallink{package}{../musixtex/musixmtab.tex}
%for typesetting  ``modern'' tablature,
%in which notes are provided with (downward) stems and beams.
%
%\item
%Don Simons has released a new PMX beta, 
%\htmladdnormallink{version 2.90}{../pmx/pmx290.zip}. It 
%supports the insertion of blank gaps in the
%middle or at the end of any system. The middle gap might be used to create a very short coda at
%the end of a system. The end gap leaves the system shorter than the others, and, like the middle
%gap, creates a space that could be used for text comments. See \texttt{BlankGaps.pdf} in the archive for details.
%
%On Windows, use \verb|pmx290.exe| instead of \verb|pmxab| and then process the resulting tex file
%using musixtex and the \verb|pmx.tex| in the archive.
%On other platforms, you'll have to compile \verb|pmx290.for| and generate a suitable executable;
%for example, \texttt{gfortran -o pmxab pmx290.for}.
%\item
%Don Simons has released a new PMX beta, 
%\htmladdnormallink{version 2.87}{../pmx/pmx287.zip}. It allows
%staff-jumping beams to change multiplicity right before or after the staff
%jump. Consult sjb.pmx and sjb.pdf for further details.
%Bob Tennent has released a beta of 
%\htmladdnormallink{MusiXTeX-1.28}{../musixtex/musixtex128beta.tex.zip}.  
%This provides new commands for repeats \emph{within} a bar, optionally
%forced to be at the end of a system.  Documentation is provided in the archive.
%\item
%\htmladdimg[alt="new 2017-03-22" title="new 2017-03-22"]{./new.gif} 
%Don Simons has produced a 
%\htmladdnormallink{beta of pmx280}{../pmx/pmx280PRE.zip}.  
%The Preface of the manual summarizes the changes,
%the most significant being 2-note tremolos.
%Please test this new feature and,
%if you have pmx scores,
%compile them with this version to check compatibility.
%\item
%\htmladdimg[alt="new 2016-03-31" title="new 2016-03-31"]{./new.gif} 
%Dieter Gl\"otzel has submitted a new
%\htmladdnormallink{beta}{../xml2pmx/XML2PMX_Windows.zip} of a MusicXML-to-PMX converter
%for testing and feedback (currently for Windows only).  
%\item
%\htmladdimg[alt="new 2016-01-31" title="new 2016-01-31"]{./new.gif} 
%Don Simons has released a beta of 
%\htmladdnormallink{PMX version 2.73}{../pmx/pmx273.zip}.  Thanks to Dirk Laurie, PMX can now handle lyrics directly, without
%having to
%use M-Tx as a pre-preprocessor.
%\item
%\htmladdimg[alt="new 2016-01-16" title="new 2016-01-16"]{./new.gif} 
%Dirk Laurie has a released a beta (release candidate) of
%\htmladdnormallink{M-Tx version 0.61a}{../mtx/mtx-0.61a.zip}.  It must be used with
%the betas of
%\htmladdnormallink{PMX version 2.72}{../pmx/pmx272.zip} 
%and
%\htmladdnormallink{\texttt{musixtex.tex} version 1.21}{../musixtex/musixtex.tex}.
%It is also available from
%\htmladdnormallink{Github}{https://github.com/dlaurie/M-Tx}.
%\item
%\htmladdimg[alt="new 2015-12-03" title="new 2015-12-03"]{./new.gif} 
%Dirk Laurie and Bob Tennent have provided a substantially expanded 
%\htmladdnormallink{\texttt{musixtex.lua}}{../musixtex/musixtex.lua} 
%script which subsumes the specialized \verb|m-tx| and \verb|pmx2pdf| scripts 
%and automatically determines which preprocessor(s) to use, even if
%the filename argument does not have an extension.
%Given a basename, \verb|musixtex| searches for
%the earliest file in the \verb|mtx-pmx-tex| or \verb|autosp-tex| chain and regards
%that as the source file. It builds the others from there on (you can
%also stop early). 
%Extension \verb|.ltx| is also recognized, and automatically
%selects
%LaTeX processing.  Some new features: a \verb|musixtex.log|
%file is generated and a \verb|-q| option diverts screen messages to
%a temporary file. 
%Full details are in the
%\htmladdnormallink{documentation}{../musixtex/musixtex.pdf}.
%All feedback welcome.

%\item
%\htmladdimg[alt="new 2015-11-27" title="new 2015-11-27"]{./new.gif} 
%Dirk Laurie and Bob Tennent have released a beta of 
%\htmladdnormallink{mtx-0.61}{../mtx/mtx-0.61.zip}.  
%\end{itemize}
%\item 
%\htmladdimg[alt="new 2015-01-09" title="new 2015-01-09"]{./new.gif} 

%\item
%\htmladdimg[alt="new 2015-02-20" title="new
%2015-02-20"]{./new.gif} 
%Bob Tennent has uploaded betas of 
%\htmladdnormallink{musixtex116}{../musixtex/musixtex116.tds.zip}
%and
%\htmladdnormallink{musixtex-fonts116}{../musixtex/musixtex-fonts116.tds.zip}.
%Unzip these archives at the root of a local or
%personal texmf tree and update the file-name database on your TeX system.

\end{itemize}

\section{More Related Software}
\begin{rawhtml}
<ul>
  <li><a href="https://ctan.org/pkg/recorder-fingering">recorder-fingering</a> is a LaTeX package 
       by Alan Munn that provides support for generating fingering diagrams for baroque fingering recorders. 
       Standard fingerings are provided for recorders in both C and F, along with methods
       to create and display alternate fingerings for trills, etc.</li>
  <li><a
    href="http://abcnotation.com/abc2mtex/">abc2mtex</a>
    is a conversion program for 
    <a href="http://abcnotation.com/">abc</a> notation which originally focussed on single-line folk music
    scores but can be used for multiple staves and should be extendible to many other types of music. 
    abc2mtex can be used as a preprocessor
    for MusiXTeX. Files for version 1.6.1 are also archived <a
    href="../abc2mtex">here</a> for convenience.</li>
  <li><a href="http://abcplus.sourceforge.net/#abcpp">abcpp</a> is a
    versatile preprocessor written by Guido Gonzato. It was originally
    designed for another music notation program
    but its
    macro and conditional output directives may be useful to users of
    MusiXTeX, PMX, and M-Tx as described in <a
    href="../cm041128.txt">Christian Mondrup's posting</a> to the MusiXTeX
    mailing list.
    </li>
  <li><a href="http://www.rosegardenmusic.com">Rosegarden</a> is an
    integrated MIDI sequencer and musical notation editor. It can import midi files and export in MusicXML format.</li>
 <li><a href="https://lilypond.org/">LilyPond</a> is a music engraving program, devoted to producing the highest-quality sheet music possible. It brings the aesthetics of traditionally engraved music to computer printouts. LilyPond is free software and part of the GNU Project.</li>
  <li>Multilingual <a href="https://lilypond.org/glossary.html">glossary</a> of musical terms.</li>
  <li><a
    href="http://noteedit.berlios.de/">NoteEdit</a>
    is a versatile notation editor for Linux by Joerg Anders.
    MusiXTeX'ers may be interested in its facilities for importing
    MIDI, MIDI keyboard input, and exporting PMX or MusiXTeX.
    NoteEdit is still maintained but new projects 
    <a href="http://canorus.sourceforge.net/">Canorus</a> and 
    <a href="http://vsr.informatik.tu-chemnitz.de/~jan/nted/nted.xhtml">NtEd</a> have evolved from it.
  <li>MPP is a preprocessor for MusiXTeX that is no longer supported.
    Files are archived <a href="../mpp">here</a> for convenience. Its
    developers have moved on to develop <a
    href="http://lilypond.org/">Lilypond</a>.</li>
  <li>Tab is a stand-alone, text-file-input program for typesetting
    lute tablature, for renaissance and baroque lutes and theorbos, in
    French and Italian notation. To learn more, visit the <a
    href="http://www.cs.dartmouth.edu/~wbc/lute/AboutTab.html">Tab</a>
    page on <a href="mailto:wbc@cs.dartmouth.edu">Wayne Cripp</a>'s <a
    href="http://www.cs.dartmouth.edu/~wbc/lute/lute.html">lute</a> web
    site.</li>
  <li><a href="http://www.quercite.com/pmw.html">PMW</a> (Philip's Music Writer) is a stand-alone C program which 
    translates a text description directly into Postscript, using a Type 1 font for music glyphs. 
  <li><a href="https://github.com/rfhh/lily-contribs/blob/master/pmx2ly/pmx2ly.py">pmx2ly.py</a> is an
    a script that converts PMX (and some raw MusiXTeX commands) into Lilypond format. It is based
    on an ancient script by Han-Wen Nienhuys, which has been updated and extended by Rutger Hofman. 
  <li><a href="https://www.ctan.org/pkg/leadsheets">leadsheets</a> is a LaTeX package 
   by Clemens Niederberger that supports 
   typesetting simple leadsheets of songs, i.e. song lyrics and the corresponding chords. It uses
   MusiXTeX music fonts. This package is available in TeXLive and MiKTeX.
  <li>The <a href="http://gregorio-project.github.io/">Gregorio</a> project provides TeX-based
   tools for typesetting Gregorian chant.
  <li>The <a href="http://www.arkkra.com/">Mup</a> program takes a text file as input and produces very high quality PostScript output for printed music. It can handle both regular notation and tablature notation. It can also produce MIDI output. It comes with a program called Mupmate that provides a menu-driven interface and integrated editor, but it can also be used in command line mode. It has been in use for music publication since 1992, and is used by musicians all over the world, including music departments at Stanford, Johns Hopkins, the University of Virginia, and other major universities.
  <li>The <a href="http://songs.sourceforge.net/">songs</a> package is a software suite that allows a user to create beautiful songbooks using LaTeX. The software can create songbooks with chords over the lyrics, songbooks with just lyrics, and sets of overhead slides for corporate singing. Chords can consist of chord names or guitar tablature diagrams but not full sheet music. 

  <li>The <a href="https://ctan.org/pkg/musicography">musicography</a> package by Andrew Cashner makes available the most commonly used symbols in writing about music for use with LaTeX. It includes accidentals, meters, and notes of different rhythmic values, taken from the MusiXTeX fonts.  The package provides a flexible, user-friendly interface written using xparse.

<li>Michael Eskin has implemented an <a href="https://michaeleskin.com/abc">on-line tool</a> for ABC scores. It supports a wide range of use cases, from interactive (tune play when you click the titles) PDF export to automatic generation of tunebook websites, includes a "Tune Trainer" for practice, and an extensive set of features for editing and manipulating ABC.

 <li>The <a href="https://ctan.org/pkg/fretplot">fretplot</a> package provides batch generation of scale and chord diagrams for plucked string instruments, such as the guitar.
</ul>
\end{rawhtml}


\end{document}
