I am not going to be presumptuous and just fill in the FAQ with all sorts of questions that I think people might ask. All of these questions are things people really have asked.

Frequently Asked Questions

Why can't I add a (photo/video/album)?
Why don't the "add photo/video/album" links show up?
Where did the name come from?
How do I install Acidfree?
Do I have to have mplayer?
Does Acidfree work with module X?
Can you add X feature to Acidfree?
Why don't video uploads work?
Why doesn't mass import work?
I am getting errors like .... What does this mean?

Frequently Given Answers

Why can't I add a (photo/video/album)?

• The most common cause of this is because you don't have permissions. Make sure the 'Create Acidfree ...' boxes are checked on the 'access control' page (admin/access).
• Another common problem is misconfiguration. I am the first to admit that Acidfree is not mere child's play when it comes to configuration. It is a complex system and requires _some_ thought to configure correctly. Your best help here is visiting the acidfree/test page (as user admin) to see what it tells you about your current setup.

Why don't the "add photo/video/album" links show up?

• The most common cause of this is because you don't have permissions. Make sure the 'Create Acidfree ...' boxes are checked on the 'access control' page (admin/access).
• You aren't logged in as a user who has permission to add stuff.

Where did the name come from?
See Overview for some history.

How do I install Acidfree?
See Installation for detailed instructions.

Do I have to have mplayer?
No. Mplayer is only needed if you want it to automatically extract the first frame from uploaded videos. Note that this requires shell_exec permissions for php. And mplayer may not be installed on your server, etc., etc. No, I will not install it for you.

Does Acidfree work with module X?
Acidfree should play well with others. If it doesn't, please open a bug and let me know. It has been tested in a wide range of setups by various users and myself, though it is impossible for me to test every situation.

Can you add X feature to Acidfree?
It all depends on how much I like it. I want to KISS (keep it simple stupid) and avoid bloatware that does everything under the sun (think Gallery2). This is something I wrote for personal use and so my mother-in-law would be able to use it also. So I want it to look nice and be simple to use and it MUST be simple to use or I will be spending my weekends as tech support for my mother-in-law.

The other thing you might want to consider is coding up you feature (or getting a friend to do it for you) and then submitting a patch. I don't have much time for real active development these days. Work is stressful, the kids are time consuming, and I don't get to spend as much time with my wife as I would like. So you might think about writing the feature yourself.

You might also consider donating a small sum of money in hopes that it might lend some motivation to me to get your pet project done. Now take note that I do not work on Acidfree for money—I am forbidden to do so by my employer. But if you happen to give me some money and I happen to implement some feature you wanted, everyone is happy.

Why don't video uploads work?
The most common problem here is a too small upload_max_filesize or post_max_size. While you are at it, make sure you fix memory_limit to be >=32M.

Why doesn't mass import work?
The most common problem here is a too small upload_max_filesize or post_max_size. While you are at it, make sure you fix memory_limit to be >=32M.

I am getting errors like .... What does this mean?
Search for those errors in the bug listings (make sure you search through the closed bugs as well). Don't automatically assume you are the first one to ever see this error and immediately open a bug. However, if after searching for the bug and finding none others, feel free to open a bug. Make sure you paste in the exact error messages and tell how to reproduce it. If I can't reproduce it, chances are, it won't get fixed.