How to Un-brick Your TokenFrame

In late November 2024, TokenFrame digital display frames went dark. Suddenly, instead of showing playlists of the owners’ NFTs, the screens would only show white lines waving on a spacey background. The company was cagey about the issue. Complaints piled up in its Discord and on social media.

Three weeks later, TokenFrame’s CEO admitted that the company had ran out of money and stopped paying server costs. The frames had become soft-bricked.

Since then, TokenFrame owners have been left without an obvious way to interact with their frames. The only authorized way to control the frames was through TokenFrame’s webapp or smartphone apps. But those had quit functioning. As of January 2025, the webapp no longer shows a section to control the frames, and the “Frames” section of my TokenFrame iOS app is stuck on an endless loop of looking for devices to connect. Beyond that, TokenFrame.com now points to a dead Shopify storefront.

Rescue prospects look grim. Though the owner has discussed resurrecting the business by pivoting to a subscription-based app, no solution has been forthcoming. On Discord, the TokenFrame owner, whose handle is CEOSilphCo, wondered aloud who would trust him to right this ship, even if there were investors willing to provide an infusion of cash to save the company.

So in the absence of a rescue plan from the company, I’m writing this article for other TokenFrame owners to lay out your options for resurrecting your TokenFrame. My goal is to allow you to display digital art on your TokenFrame hardware by bypassing the TokenFrame app that comes preinstalled on your device.

Preparation

The solutions in this article assume you have a TokenFrame with at least one USB port. Not all TokenFrames may have a USB port. For devices that only have one port, you may be able to plug in a USB hub to allow you to connect more USB devices at once, such as a mouse, a keyboard, and a USB stick.

For safety, I recommend that you unplug your TokenFrame any time you unmount it from the wall.

To begin, unplug your frame, then remove it from the wall so you can access the USB port on the back. Plug in a mouse into a USB slot. (I use a wireless Logitech mouse. A wired mouse probably works better, as the physical frame seems to block much of the wireless signal from my mouse.)

A TokenFrame display is shown with a generic, space-like image of white dots on a black background taking up the full screen

Once you have the mouse plugged in, plug your TokenFrame in again and let it load the TokenFrame app (about 1 minute). TokenFrames run on an Android operating system, so your device will first boot up (showing a space-like screen, without any lines or TokenFrame logo), and then will briefly show you the Android home screen before launching into the TokenFrame app.

Typically, at this point the TokenFrame app will show wavy lines on a space-like background, or else will show a list of nearby wifi networks. Unless something changes on the TokenFrame server side, you can’t do anything with these screens, so at this point, you need to exit out of the app.

There are various ways to navigate the device with your app, and they may vary based on what mouse you use, and your TokenFrame hardware and software. Before I tell you about them in the section below, just know that your destination is the Settings app, so get there any way you can.

Once there, click on Apps, then TokenFrame. Use the Force Quit option to close the app, and prevent it from taking over your screen when you restart it (until and unless you open it again). If there is an option to disable it from being your “home app”, avail yourself of that as well.

Mouse Navigation with TokenFrame Displays

If you’ve already accessed your device’s settings and made the changes noted above, you can skip this section. Otherwise, here are some tips to help you find your way around the frame.

Once you have your mouse plugged in to the USB port, try pressing the mouse’s scroll wheel. That may take you directly to the settings app.

If that doesn’t work, try clicking the right mouse button. For me, that acted as the Android “back” button. I was able to use that method to access the home screen, from which I could access the settings app.

If you’re not getting anywhere, try holding both mouse buttons for 30+ seconds, then clicking them at the same time.

Try also holding your mouse at the bottom edge of the screen, which will bring up some navigation options. You may also have options by clicking or dragging down the top edge of your screen.

Explore the navigation features in your Settings app to enable various options that suit you, e.g., displaying navigation buttons at the bottom of the screen.

Now, you’re ready to explore the solutions.

Solutions for Unbricking your TokenFrame

Option 1: Download Another Display App from the Play Store

If you’re lucky, your TokenFrame has the Google Play Store installed as an app, so go look for it in your apps folder.

Launch it, and use it to search for any display app that is live in the Google Play Store, such as the BlackDove Canvas app or WhiteWalls app (expected to be released soon). Download your preferred app, open it, and follow that app’s instructions.

Congratulations, you’ve unbricked your TokenFrame!

If you’re unlucky, the Google Play Store has been deleted from your device. (This was the case for me.) You could try reinstalling it, either by downloading the Play store from the internet, or by sideloading it through a USB. You’ll probably want to make note of your Android version from the Settings app and find a matching build of the Play store from the internet.

Personally I did not have success downloading the Play store from the internet. I tried installing several builds of the Play store from a mirror site accessed via Chrome on the device, but the downloaded apps would crash immediately upon opening.

I have not tested loading the Play Store from a USB. In theory, you would download the Play Store APK to the USB device, plug that into the TokenFrame, navigate to the USB stick using the frame’s file explorer, and then install the app.

Option 2: Use the Browser

If you don’t have the Play store app on your device and don’t want to mess around with installing it, the next option is to use the TokenFrame’s browser to find a solution to display your NFTs.

Find the Chrome app, open it, and use the URL bar to navigate the web as normal.

Try view.art for a free, easy solution for casting your NFTs. Use your computer to sign up for the service, either via email (via magic link) or wallet login (Metamask, Rainbow, Coinbase, or WalletConnect). Then create a channel and enter your wallet address or ENS name (no authentication necessary!). Now, select from the available NFTs you want to display. (Don’t pick your biggest files to start with – sometimes they crash the browser.) When you proceed, you’re given a unique URL for your new gallery.

A colorful image of a person sitting with crossed legs in a cyberpunk scene.

Now just plug that unique URL into Chrome on your TokenFrame, and bam! – you’re viewing a carousel of your tokenized art. This is definitely the breeziest setup of any solution I’ve used so far. I wouldn’t call the UI fully featured, but it does what it needs to do. Just don’t be surprised if and when they start charging a subscription fee. (Somebody’s paying these server costs!)

Another web-based solution is Zeroframe. Zeroframe casts your uploaded images to virtual frames, which you can display on any web-enabled device using a unique URL. At the moment Zeroframe only displays uploaded images or images pulled from URLs, but I’m told they’re launching support for casting NFTs soon. (I found the ZeroFrame team very friendly and responsive while writing this article – special thanks to Ishac for all the info!)

In an artwork on a TokenFrame display, a couple snaps a photo in a yellow field. A structure with an Eastern-style roof is visible on a hill behind them.

Use a magic link to easily sign up for Zeroframe with your email. Upload the artworks or other images you want to cast, making sure to fill in Title and Artist if you plan for those fields to display on your image. Create a collection (basically a playlist), and then a virtual frame. Then use that frame’s unique link to see your art. You can even test the link in a tab on your computer.

Zeroframe is free to try for 7 days, and they’re giving everyone 3 free months with the code HAPPY25. After that, pricing is $9/month for one virtual frame with 500mb of storage, and other options for power-users and galleries.

Congratulations, you’ve unbricked your TokenFrame!

Option 3: Sideload a Solution

This option involves installing an app onto your device via a USB stick. My 32″ TokenFrame has two USB ports, allowing me to use one for the mouse, and the other for a USB drive. If you don’t have two ports, try using a USB hub so you can plug in both of these things at once.

Find an app that allows you to download their APK. White Walls, BlackDove, and Zeroframe all have APKs available specifically for TokenFrame users. Use a computer to save the APK file to your USB stick. Then, plug the stick into the TokenFrame and follow the app developer’s instructions at the links above to get the software running on your frame.

Congratulations, you’ve unbricked your TokenFrame!

My favorite sideloaded solution is White Walls due to their support for Tezos alongside Ethereum, Solana, and Ordinals. It’s truly gratifying to finally be able to cast my Tezos collection directly to my TokenFrame. (The White Walls display app is also available on Apple TVs, if you happen to have one of those.) Oh, and it’s currently free! The company says pricing will be announced in the future.

Tezos art displaying on my TokenFrame through the White Walls app. Art by @Mosieur_Costard

Option 4: Use the Device’s Operating System

If the above options aren’t working for you, or if for some reason you’ve lost internet access to your device, your only option is to use the onboard file explorer to display your art.

This actually isn’t so bad. I found that the device did a great job displaying art that I had loaded onto my USB stick, including GIFs. You can even set up a basic slideshow, so the device scrolls through your art.

For this solution, use your computer to load the files that you want to display on your screen onto a USB stick. Then, plug your USB stick into your TokenFrame and navigate from the home screen to your file explorer app. Click on the USB stick, find your files, and open them to enjoy.

If you’re having issues with the file explorer app, try accessing the USB stick through the Gallery app.

As a bonus, by using the OS, you now have the ability to display any photo, video, or gif that you want on your frame, just like a regular Android device – no need for it to be on the blockchain. (That might not sound so exciting, but remember, the point of TokenFrame hardware was to lock it down so that you could only display NFTs. And at this point, I’d rather have a frame that can display any photo I want, now that I’ve experienced all aspects of the alternative approach!)

Congratulations, you’ve unbricked your TokenFrame!

If Your Frame Doesn’t Always Turn On

If your frame is only turning on at certain times of day, or if your frame turns off every time you launch the TokenFrame app, it may be operating on the display schedule you had previously set up for it in the TokenFrame app.

In my case, the display was set to turn on between 5PM and 10PM. This schedule stuck, even after the TokenFrame app stopped working. Frustratingly, even restarting the frame during the scheduled down time did not fix the issue: after booting, the frame would quickly load the TokenFrame app, and then the frame would shut off until its scheduled time to “wake up”.

Since there’s no way to change this settings schedule anymore from within the TokenFrame app, you’ll have to find a way around it. The solution is to force quit the TokenFrame app as described in the Preparation section of this article. Then just don’t open the TokenFrame app again… ever.

I recommend embarking on this during your scheduled hours, so you don’t have to fight the restarting cycle during scheduled down time.

A Note of Contrition

While I am frustrated at this situation as a TokenFrame customer, I also regret that I had recommended TokenFrame (alongside Muse Frame) on this blog as my pick for best NFT display frame of 2024.

My pick was based on TokenFrame’s commitment to displaying only the user’s authenticated, owned NFTs on the frame, rather than giving users the ability to cast any image. I felt at the time that this was the only approach that delivered on the premise of NFT art: if you see an image on this screen, you know that the owner bought this NFT. Without such a feature, it would be hard to say whether an image displayed on the frame was an NFT that the owner purchased, or just a right-click-saved jpeg uploaded from a phone.

But TokenFrame’s solution was double-edged sword, in that it created a central point of failure for the whole experience: No functioning TokenFrame company, no authenticated casting of your NFTs. If that sounds like “Not your keys, not your crypto“, it’s not accidental: crypto users have been burned many times by companies whose business models have left customers in the dust once the money stopped flowing. Add another example to the list of reasons why we should be striving toward the ideals of self-custody and trustlessness.

For what it’s worth, my other pick for the best display frame of 2024, Muse Frame (affiliate link), contends that customers would be in better shape if their company folded, since Muse branded displays ship with remotes that allow customers to directly control them as Android devices right out of the box.

Conclusion

Hopefully, with the solutions outlined above, you’re able to rescue your TokenFrame and continue displaying your favorite digital art with it.

If this article helped you resurrect your TokenFrame, I’d love to see the outcome! Please tag me with your pic on X (or your social media app of choice – I’m on most of them as Niftyist).

The Nifty Dictionary: Shill

DEFINITION

To shill means to advertise one’s creations or items available for sale. NFT creators and NFT sellers may both shill their works to find potential buyers.

CONTEXT

The NFT market is a crowded space, which means creators often have to do a certain amount of self-promotion to stand out and make sales. Shilling is the result, which is what it’s called when creators or resellers advertise their goods for sale in public spaces such as on Twitter, Reddit, or Discord.

While shill is a standard English word, it usually carries a negative connotation in general use, implying that the seller is promoting any sort of item that might make them some money, wither it’s a good value or not. It’s often paired with the word “shameless.” In the NFT world, shilling can carry the same negative context, since blatant self-promotion often can often come across as spammy.

But given the economic realities of a crowded marketplace, many people in the NFT community understand that a certain amount of shilling is healthy for the market. After all, almost everyone who buys NFTs will find themselves needing to sell off a piece sooner or later, and in a sometimes illiquid market, that can be hard to do without advertising.

And so, the word shill has been embraced by the community in a tongue-in-cheek way, and can sometimes be used as a neutral term for self-promotion. For example, a Discord server admin may set aside a dedicated channel for creators to shill their works – ensuring the artists who are part of their community have a reliable outlet they can use to hustle for that next sale.

The Nifty Dictionary: Lazy Minting

DEFINITION

Lazy minting is a way of minting an NFT without having to pay upfront gas fees. In other words, this method allows someone to create an NFT for “free”.

CONTEXT

Any transaction on the Ethereum network requires payment of a fee known as gas. Creating an NFT counts as posting a transaction to the network, and therefore requires gas to be paid.

While gas is a critical feature of Ethereum, high gas fees can disincentivize people from creating NFTs at all. Minting fees can be especially daunting for first-time NFT creators, who may not know whether anyone will be willing to pay for their work.

To solve this problem, OpenSea introduced lazy minting in late 2020, which requires no gas fee to be paid when creating the NFT. Other NFT creation platforms have since added support for the feature. (Update: OpenSea announced in 2023 that they will be deprecating this feature. Other platforms may continue to use the terminology.)

Lazy minting works by essentially creating the metadata for the NFT, without actually creating an instance of the NFT itself. Once someone purchases that nifty, it is then officially minted, and a gas fee is incurred. Typically, the fee is rolled in to the buyer’s cost.

Lazy minting on OpenSea uses the ERC-1155 standard, which allows for the creation of many instances of an item, as opposed to the single-instance items supported by ERC-721.

Note that just because some platforms support lazy minting, the costs of creating and selling niftys may still not be entirely free. On OpenSea for example, the seller must pay an upfront network fee to create a “collection” before they will be able to mint an NFT, lazily or otherwise.

Introducing Niftyist

Niftyist is a blog and network covering NFTs!

At the beginning of 2021, I found myself falling down the NFT rabbit hole, beginning to collect art on Nifty Gateway as I learned about the blockchain technology at the heart of this innovative technology. Several months later, I was deep down the rabbit hole, spending several hours a day continuing to learn about the space and trying to keep up with all of the exciting developments (a wildly impossible task).

In the midst of the coronavirus pandemic, I’ve found myself physically isolated from friends and struggling to meet new people. I’ve always loved teaching and sharing my excitement and passions with other people, and decided to create an online outlet where I can do that and get involved in the community. I hope that this site will help me get acquainted with innovators, artists, fans, collectors, technologists, and others who I hope to meet in person one day not too far in the future.

In addition, I see the potential for Niftyist to become an income stream. I will be exploring ways of monetizing content, such as posting links to awesome NFT pieces that will allow me to collect a “bounty” or affiliate fee.

I’m not sure exactly what Niftyist will look like in the months or years ahead. I just know that I’m super excited about the NFT space and I’m looking forward to connecting over that with you! Onward! 😀