Skip to content
Bash script to retrieve modules from
Branch: master
Clone or download
Pull request Compare This branch is 64 commits ahead of demonicsweaters:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

moddownloaderr - a bash script that downloads tracker created module music files (.mod, .med, .xm, .it, .s3m) from You can use various category or search criteria, as well as save locations for each download session, or set the maximum number of tracks to download. This is a quick way to get a huge mod library on your computer.


Based on the modarchive script by Fernando Sancho AKA 'toptnc' -, modifications by Justin Wierbonski aka Demonic Sweaters -, and updates by Milk Brewster -

0.2 - the initial fork and basic clean-up 0.3 - mostly about fixing genre downloads 0.4 - a major bugfix and further polishing


Required packages:

  • wget
  • sed
  • grep
  • awk

Available from the AUR for Arch Linux and related distros.

Quick setup:

mkdir ~/bin
cd ~/bin
git clone
ln -s moddownloaderr/moddownloaderr


Warning: do not run multiple copies at the same time (yet).

Mod Downloaderr options:
  -h               Show this help message
  -n <number>      Optionally cap the total number of tracks to download
  -s <section>     Download from selected section: Can be one of this
       uploads     This is a list of the recent member upload activity, 80 files
       new         Same a uploads but using search engine, 150 files
       featured    These modules have been nominated by the crew for either
                     outstanding quality, technique or creativity (or
                     combination of).
       favourites  These modules have been nominated by the members via their
       downloads   The top 1000 most downloaded modules, recorded since circa
       topscore    This chart lists the most revered modules on the archive.
       random      Ramdom module from entire archive
   -a <artist>     Search in artist database
   -m <module>     Search in module database (Title and Filename)
   -g [<genrenum>] Download a specific genre. Either enter the
                     genres number, or select from a list.
   -d              Enable debug message output.
Hint: Use + symbol instead blankspaces in search strings.
Hint 2: If you're running Mac OSX, you must first run this command before the
script will run:
  function _wget() { curl "${1}" -o $(basename "${1}") ; }; alias wget='_wget'
Hint 3: Use 'MDDEBUG=1 moddownloaderr' to enable debug output.
Hint 4: Some tracks are in more than one genre category. Use dupeguru to remove
duplicate files.

Use Mixxx to DJ modules (details). See also

You can’t perform that action at this time.