NanoTracker

Shared catalogue — frequently asked questions

Short answers. For the actual steps there is the step-by-step guide, which walks you through whichever situation you are in.

The basics

What is the "shared catalogue", and why would I want one?

NanoTracker keeps a list of what is on your disks. By default that list lives on the computer it is installed on: if there are two of you, each of you only sees the disks they catalogued themselves.

With a shared catalogue the list is one single list for the whole studio. Anyone can search for a job and find out which disk it is on — and if that disk is plugged into a colleague's computer, it says so, with the machine's name.

If you work on a single computer you do not need this: what you have is fine.

What is MariaDB? Do I have to install another program?

MariaDB is the program that acts as the warehouse for the shared list. It sits on something that stays switched on — a NAS or a computer — and everyone else asks it for information over the network. It is free, very widely used, and has no interface: once it is running you never open it again.

On your computer you install nothing: NanoTracker simply talks to it. It only goes on the machine acting as the warehouse, once.

On a NAS it is a ready-made package, installed with two clicks from the NAS's own store. On Windows it is an ordinary program to download.

Do I really need a NAS?

No. What you need is something that stays switched on while the others are working, and a Windows computer in the studio will do perfectly well. If that computer is off, the others cannot see the shared catalogue (but they carry on working — see below).

A NAS is the most common choice because it uses little power and is always on, not because it is required.

Do my files and photos end up on the NAS?

No. NanoTracker copies no files at all. The catalogue holds only the names: what the folders are called, where they are, how big they are and when they were last changed. Your material stays where it is, on your disks.

That is why a catalogue covering dozens of disks takes only a few megabytes.

Do I need an internet connection?

No. The shared catalogue works over your studio network: the computers and the NAS need to see each other, they do not need to reach the internet. From outside the studio, on a laptop, the shared catalogue is not reachable (unless you already have a company VPN set up).

A colleague is on a Mac and I am on Windows. Does it still work?

Yes. The same catalogue is used from both sides.

Windows and macOS identify disks differently, so the same physical disk can end up catalogued by both: NanoTracker notices and shows it as a single entry, noting underneath which computers have seen it.

Creating the shared catalogue and connecting to it

How do I create a shared catalogue?

It depends where you want it, and those are three different routes. The step-by-step guide opens with exactly that question and then shows you only the steps for your situation: on a NAS, on a computer, or connecting to one that already exists.

In short: you install MariaDB on whatever will act as the warehouse (that part is manual — it is its own package), and then NanoTracker does all the rest — it creates the database, the user and the permissions by itself.

Settings → Database → Shared → +

How do I find out my NAS's address and port?

The address is a number like 192.168.1.101. You will find it in the NAS's own program on your computer, or in your router under connected devices: the guide has a dedicated box with four ways to find it, and the same for everything else it asks you for.

The port is almost always 3306 and you can leave it alone. NanoTracker has a "Check NAS" button that tries it for you and tells you whether the NAS answers, before it even asks you for a password.

Do I have to open anything in the firewall?

If the warehouse is on a NAS: no — you just switch on the network connection in the MariaDB package's settings (one tick box, it is in the guide).

If it is on a Windows computer: yes, port 3306 has to be allowed. NanoTracker offers to do it for you during the setup.

How do I connect the other computers?

You need four things: address, database name, user and password — the same ones chosen when it was created. On every other computer:

Settings → Database → Shared → + → Connect to an existing one

The "Test the connection" button tells you straight away whether it works, so you do not find out about a typo two days later.

The catalogue you already have

I have used NanoTracker on my own for months. Do I lose everything?

No. The catalogue on your computer stays where it is, and NanoTracker can copy it into the shared one. You do not have to plug in or rescan a single disk.

Settings → Database → Copying the catalogue

How do I copy my catalogue into the shared one?
  1. Open Settings → Database and scroll down to "Copying the catalogue".
  2. Choose the direction: From my computer to the shared database.
  3. Press "Work out what would change". Nothing is copied yet: it tells you how many folders would be added, how many updated, and how many are already identical.
  4. A list of disks appears with tick boxes. Leave them all ticked, or untick the ones you do not want to bring across.
  5. Press "Copy the selected disks" and wait for the confirmation.

Step 3 is there on purpose: with a studio catalogue nobody should press a button without first knowing how many rows will move. It costs one second.

Does the copy delete anything?

Never. The copy only knows how to add and update. If a folder exists at the destination but not at the source, it stays exactly where it is.

That is deliberate: if something is missing from one side, it almost always means that computer never catalogued that disk — not that the folder is gone.

Can I go the other way, from the shared one to my computer?

Yes — same command, direction reversed. It is useful if you are about to take a laptop out and want the studio's full list with you even with no network.

What if the same disk is already catalogued on both sides?

That is the normal case, and it is handled: the two catalogues merge, they do not duplicate. NanoTracker recognises the same physical disk even if it has been renamed or reformatted.

For folders present on both sides, the more recent version wins: an older one never overwrites a newer one.

If I run it twice by mistake, does everything double up?

No. The second time it finds nothing left to add, and says so. You can run it again without worrying — it is built precisely for people who are not sure the first attempt worked.

When something goes wrong

How do I know which catalogue I am using right now?

The name of the database in use is always shown at the bottom left of the NanoTracker window. In Settings → Database the green dot marks the active one.

The NAS is off, or the network dropped. Do I lose work?

No. If the shared catalogue stops answering, NanoTracker switches by itself to the one on your computer and carries on. When the shared one becomes reachable again it goes back to it on its own and brings the disks touched in the meantime up to date.

There is nothing to do, and nothing to remember.

"Check NAS" says the NAS does not answer. What do I look at?
  • Is the MariaDB package on the NAS installed and started?
  • Inside its settings, is the network connection (TCP/IP) enabled? It is often off by default, and this is reason number one.
  • Is the address right? Try opening it in a browser: if the NAS's own page does not come up either, the problem is the network, not NanoTracker.
  • If the NAS also has an older MariaDB on it, the newer one may be on port 3307 rather than 3306.
It says the server is there but will not accept this computer.

That is a different answer from "no reply", and it is good news: the warehouse is running, it just has to be allowed to accept other computers. On a NAS that is the network-connection tick box; on Windows it is the "enable access from remote machines" tick box shown while MariaDB is being installed.

Can I go back to the catalogue on my own computer?

Yes, at any time, from Settings → Database → Local. Your computer's catalogue is never deleted when you move to the shared one: it is always there.

Did not find your answer? Write to support@nanotracker.pro. If the problem is in the program, Settings has "Having problems?": it prepares a technical report and shows you what is in it before sending.