AMPLE(1)

✨ AMPLE(1) — User Manual 💖

🎀 NAME

okay bestie, the name is ample 🦋 and it's an Ample MP3 server 🎧✨

💅 SYNOPSIS

ample [OPTION] [PATH...]

🌸 DESCRIPTION

okay so ample is an MP3 server and it is literally so iconic 😭 it lets you listen to your music no matter where it's stored, locally or remotely 🎶 it is NOT trying to do mixing or radio shows or anything extra, it's just an easy way to play your MP3s everywhere using the "open location" feature that's already in XMMS, WinAmp and Media Player 🔥 after you install, configure and start ample, try connecting to http://server:1234/ with the "open location" feature in your fave MP3 player, or go to http://server:1234/index.html in your favourite web browser 🌈 main character energy fr fr 💜

👑 OPTIONS

• -p NUM, --port=NUM — listen on TCP port NUM 🔌 (it defaults to 1234, so no stress 🙈)
• -o, --order — when a list of files gets requested, play them in alphabetical order 🔤✨
• -c NUM, --clients=NUM — allow a max of NUM clients connected at the same time 🫶
• -n, --norecursive — ngl this one's a vibe check: it stops ample from automatically indexing files in subdirs of the directories being indexed 🙅‍♀️
• -f FILE, --conffile=FILE — use FILE as your config file instead of the default /etc/ample.conf 🎀 see ample.conf(5) for the deets 💅
• -m FILE, --htmlfile=FILE — use FILE as your HTML template instead of the default /etc/ample.html 🍓 see ample.html(5) for the full tea ☕
• -h, --help — shows a help message and then exits 🧚
• -d [NUM], --debug[=NUM] — prints debug messages 🐛 the higher the NUM, the more detail you get 🔍
• -t, --trace — disables forking and backgrounding 🙅‍♀️ super useful for debugging 💀
• -v, --version — shows version info and then exits 🌟
• -i [PIDFILE], --pidfile [PIDFILE] — writes a PIDFILE so ample can be handled as a daemon 👻
• [PATH...] — these are the path(s) to files or directories that Ample uses to fill up its list of MP3's 🎵 if PATH is a directory, all the files get added (possibly recursively, see the -n option above) 📂 if PATH is a regular file ending with .mp3, it gets added 🎧 and if it's a regular file ending with .m3u (an MP3 playlist), the files listed inside get added too 📝

🧚 FILES

• /etc/ample.conf — the default config file (you can use another one, see the -f option above) 🎀 see ample.conf(5) for more details 💖
• /etc/ample.html — the default HTML template file (you can use another one, see the -m option above) 🌸 see ample.html(5) for more details ✨

💀 BUGS

Of course it's totally bugfree or your money back :-) 😭🫶

🦋 AUTHOR

David Härdeman <david@2gen.com> 👑

💜 SEE ALSO

ample.conf(5), ample.html(5) 🌈

Bestie, this manual is from Ample (version source unspecified in the page), dated JANUARY 2002 🎀 Thanks for reading, you're literally the best 🫶💖✨