Advanced Compo Manager

Advanced Compo Manager is a new compo manager coded by mukunda. It features advanced features such as auto-guessing who made which track and reading votes of all kinds of formats off the clipboard. It's great, really.


                 Automatic Compo Manager - User's Manual (v1.1)

What is Automatic Compo Manager?

Automatic Compo Manager (ACM) is a program that eases the difficulty of 
hosting a competition with many participants.
ACM is designed to handle most of the tedious work of hosting a compo 
to allow you to spend more time with the participants, or your children.

Basic Usage Guide

To start a compo session, open a command prompt and navigate to the 
compo directory.
Start ACM with all of the entries (files) supplied as arguments.

C:\compo>acm song1.xm test.xm tens.xm

ACM will start and attempt to load information from the entries, such 
as their titles. When it's done, you will see the command prompt "$".

To add a member, or a voter, use the 'add' command.

$ add thisman

There are two ways to use the add command, if you supply only the name
of the member, then the vote text will be read from the Windows clipboard.
Another way to add votes is to simply type them in after the name.

$ add thisman song3 test tens

This is for rare circumstances when a voter gives retarded input to you.
The input in this method is more strict, each term mentioned should
represent a song. To save on typing, you can also abbreviate entries,
the program will complain if there are ambiguous terms.

$ add thisman s t ten

This will do the same as the command above.

$ add thisman s t te

This will generate an error because not enough information is present
to resolve t and te (which may both represent test and tens)

After the votes are added, ACM will print a summary, it may be a good
to briefly compare the summary with the user's votetext (if using the
automatic method), since humans can do a much better job at parsing 

After you have added all the necessary voters, you can use the 'print'
command to view the results. You can also use 'print <file>' to print
a detailed report to the given text file (for the internets).

Extra Voters, and Non-Voters

Sometimes some other people want to join in the fun of voting. To add
their 'extra' votes, use the 'extra' command, rather than the 'add'

$ extra thisman

The 'extra' command works the same way as the 'add' command, except it
creates an 'extra' member, so it does not become associated with an

Now, sometimes a participant has IRL things to attend to and can't vote.
Normally, all of the entries are resolved based on each participants
vote text. But in this case, the entry that the particpant made needs 
to be 'resolved' manually.

$ resolve thisman tens.xm

( can abbreviate it)
$ resolve thisman ten

This creates a member without vote text and assigns an entry to him. You
will get an error if you attempt to print the votes without fully
resolved entries.

Now, when calculating the results, each member will get a 'voting bonus'
if they have voted. If they haven't voted, they will miss out on this
bonus and their entry will be penalized. A way to avoid this penalty on
the poor participant is to have an extra voter vote in his place. This
is done with the 'merge' command. 'merge' can only be used when one
of the member's is an 'extra' member that has voted, and the other is
a 'resolved' member that is assigned and entry, but hasn't voted.

$ merge extraman thisman

This will delete 'extraman' from the member list and assign his votes
(removing thisman's entry from them) to thisman.'

Status and Swapping

You can view the status of the compo with the 'list' and 'view' commands.
The 'list' command prints out a summary of all the member's in the compo.

$ list
[X] dude1, Entry: song1.xm
[ ] dude2, Entry: test.xm
[X] dude3, Entry: tens.xm
[X] dude4, Extra Voter

The [X] box tells you if they have voted or not. As you can see, dude2
hasn't voted and will not receive a voting bonus! There is an extra
voter though, the 'donate' command can be used to save dude2 from
certain pain.

$ donate dude4 dude2
$ list
[X] dude1, Entry: song1.xm
[X] dude2, Entry: test.xm
[X] dude3, Entry: tens.xm

Now dude4 has been merged with dude2. You can view the votes of any
member with the 'list <member>' command.

$ list dude2
dude2 has voted:

If for some reason someone's votes got messed up, you can rearrange them
manually with the 'swap' command.

$ swap dude2 song1 ten
$ list dude2
dude2 has voted:

Finally, another status view you can use is the entry list. To show this,
use the 'view' command.

$ view
 - song1.xm (untitled), Author: dude1
 - test.xm (untitled), Author: dude2
 - tens.xm (untitled), Author: dude3

Other Commands

One other command is the 'toggle' command. Usually, the extension of the
filenames are ignored when searching for terms in the vote text. The
'toggle' command will toggle whether or not '.' is a delimiter character.
This is for the rare case when one entry's filename is the same as
another, but with a different extension.


If someone always wins and you want other people to win for a change, you
can use the 'handicap' command to make it more fair:

$ handicap reduz 999

Ending the session

To end your ACM session, use the 'quit' command. It will prompt you to
make sure this is desirable. Make sure you don't forget to print a report
for the internets!



$ BONUS thisman 8000


Sura Sshu,
Feb 13, 2009, 7:44 PM