Bulk Rename

To update the names of many peers at once (or to register many new peer identities at once), follow these steps:

  1. Click the Admin link in the app header.

  2. Click the Peers link in the Administration panel.

  3. Click the “a b” (Bulk Rename) icon on the right side of the Peers panel.


Enter (or copy and paste) a list of comma-separated values into the CSV field. The first two values of each line should be the public key and the new name for a peer identity.

For example, with a header line (headers are ignored):

PublicKey, Name
/TOE4TKtAqVsePRVR+5AA43HkAK5DSntkOCO7nYq5xU=, Alice's Laptop
fE/wdxzl0klVp/IR8UcaoGUMjqaWi3jAd7KzHKFS6Ds=, Bob's Phone
jUd41n3XYa3yXBzyBvWqlLhYgRef5RiBD7jwo70U+Rw=, Carla's Workstation

Or with names first:

Alice's Laptop,/TOE4TKtAqVsePRVR+5AA43HkAK5DSntkOCO7nYq5xU=
Bob's Phone,fE/wdxzl0klVp/IR8UcaoGUMjqaWi3jAd7KzHKFS6Ds=
Carla's Workstation,jUd41n3XYa3yXBzyBvWqlLhYgRef5RiBD7jwo70U+Rw=

Or quoted, with extra fields (extra fields are ignored):

"Public Key","Name","Device","OS"
"/TOE4TKtAqVsePRVR+5AA43HkAK5DSntkOCO7nYq5xU=","Alice's Laptop","MacBook Pro (13-inch, M1, 2020)","macOS 12.4"
"fE/wdxzl0klVp/IR8UcaoGUMjqaWi3jAd7KzHKFS6Ds=","Bob's Phone","iPhone 12","iOS 15.0.2"
"jUd41n3XYa3yXBzyBvWqlLhYgRef5RiBD7jwo70U+Rw=","Carla's Workstation","iMac (Retina 5K, 27-inch, 2020)","macOS 12.4"

Or tab separated:

/TOE4TKtAqVsePRVR+5AA43HkAK5DSntkOCO7nYq5xU=	Alice's Laptop
fE/wdxzl0klVp/IR8UcaoGUMjqaWi3jAd7KzHKFS6Ds=	Bob's Phone
jUd41n3XYa3yXBzyBvWqlLhYgRef5RiBD7jwo70U+Rw=	Carla's Workstation

Once entered, a table will appear below the form to preview the public key and name values identified from the CSV content.

Form Submit

Click the Update button to submit the form and rename (or add) the specified peer identities. Your changes will take effect immediately.