NTFSLABEL(8)

💅 ntfslabel(8) — the girlies' guide to NTFS labels

Okay so bestie, welcome to ntfslabel, straight out of the System Manager's Manual, section 8. This is the little tool that reads and writes the label on an NTFS file system — and lowkey it can do serial numbers too. Let's get into it. 🎀

---

✨ NAME ✨

ntfslabel — display/change the label on an ntfs file system

No cap, that's the whole vibe. It shows the label, or it changes the label. Pick your fighter. 🦋

---

🌸 SYNOPSIS 🌸

ntfslabel [options] device [new-label]

That's it, that's the whole incantation. Device first, label second (if you're feeling spicy). ✨

---

💖 DESCRIPTION 💖

So here's the tea: ntfslabel will display or change the file system label on the ntfs file system located on device. And it can also change the serial number of the device — yes, the serial number, she contains multitudes. 👑

If the optional argument new-label is not present, and no option is present, ntfslabel will simply display the current file system label. Just a little peek. A vibe check, if you will. 🌈

If the optional argument new-label is present, then ntfslabel will set the file system label to be new-label. NTFS file system labels can be at most 128 Unicode characters long; if new-label is longer than 128 Unicode characters, ntfslabel will truncate it and print a warning message. So like... don't write a novel in there, she will cut you off mid-sentence 💀

It is also possible to set the file system label using the -L option of mkntfs(8) during creation of the file system. Very "set it at birth" energy. 🍼

---

⭐ OPTIONS ⭐

Below is a summary of all the options that ntfslabel accepts. Nearly all options have two equivalent names. The short name is preceded by - and the long name is preceded by --. Any single letter options, that don't take an argument, can be combined into a single command, e.g. -fv is equivalent to -f -v. Long named options can be abbreviated to any unique prefix of their name. Slay, efficiency. 💅

• -f, --force — This will override some sensible defaults, such as not working with a mounted volume. Use this option with caution. Like, she's holding the guardrail for a reason, bestie 😭
• -h, --help — Show a list of options with a brief description of each one. The classic "what does anything do" button 🫶
• -n, --no-action — Don't actually write to disk. All the drama, zero of the commitment 🙈
• -q, --quiet — Reduce the amount of output to a minimum. She's giving less is more 💜
• -v, --verbose — Increase the amount of output that ntfslabel prints. The label and the serial number are displayed. She's giving main character energy, telling you everything 🔥
• -V, --version — Show the version number, copyright and license for ntfslabel. Receipts, basically 🧾

🦋 the serial number options 🦋

Ok these two are doing the most, pay attention:

• --new-serial[=ssssssssssssssss], or --new-half-serial[=ssssssss] — Set a new serial number to the device, either the argument value, or a random one if no argument is given. The serial number is a 64 bit number, represented as a sixteen-digit hexadecimal number, used to identify the device during the mounting process. As a consequence, two devices with the same serial number cannot be mounted at the same time on the same computer. 💀 That's not a vibe, that's a conflict. This is not the volume UUID used by Windows to locate files which have been moved to another volume.

The option --new-half-serial only changes the upper part of the serial number, keeping the lower part which is used by Windows unchanged. In this case the optional argument is an eight-digit hexadecimal number. Half the chaos, half the commitment ✨

⚠️ Real talk: duplicate serial numbers = can't mount both at once on the same computer. Say it with me: unique. 🎀

---

🐛 BUGS 🐛

There are no known problems with ntfslabel. Iconic behavior, honestly, she's flawless. But if you find a bug please send an email describing the problem to the development team:

ntfs-3g-devel@lists.sf.net

They want the lore, so give them the details 🌸

---

👑 AUTHORS 👑

ntfslabel was written by Matthew J. Fanto, with contributions from Anton Altaparmakov and Richard Russon. It was ported to ntfs-3g by Erik Larsson. Legends, every single one 🫶

---

🌈 AVAILABILITY 🌈

ntfslabel is part of the ntfs-3g package and is available from:

https://github.com/tuxera/ntfs-3g/wiki/

Go get her, she's right there 💖

---

🔗 SEE ALSO 🔗

• mkntfs(8)
• ntfsprogs(8)

The friend group. The squad. The whole ecosystem 🧚

---

k bye bestie, go label something cute 💅✨ — this was the ntfs-3g 2026.9.28 edition, dated January 2012, signing off 🎀🌟