🖥️ Tidbyt Base NFT Display

Display your Base network NFTs on your Tidbyt device with style! This app fetches NFTs from your Base L2 wallet and creates an engaging display that shows two NFTs side by side, rotating through your collection.

✨ Features

• 🎨 Display NFTs from Base blockchain
• 🔄 Auto-rotate through your NFT collection every 5 seconds
• 👥 Show two NFTs side by side
• 🖼️ Show NFT images and titles
• ⚡ Support for large NFT collections (up to 1000 NFTs)
• 🔐 Secure configuration handling
• 🎯 Optimized display for Tidbyt LED matrix

📋 Prerequisites

Before you begin, ensure you have:

• 📱 A Tidbyt device
• 🛠️ Pixlet installed
• 🔑 An Alchemy API key
• 👛 A Base wallet with NFTs

🚀 Quick Start

1. Clone the repository:

git clone https://github.com/ASTM79/tidbyt-base-nft-display-public.git
cd tidbyt-base-nft-display-public

2. Set up configuration:

cp config.template.json config.json
nano config.json  # Edit with your credentials

3. Make the update script executable:

chmod +x update.sh

4. Run the display:

./update.sh

🔧 Configuration

Create your config.json from the template and fill in:

{
    "wallet_address": "YOUR_WALLET_ADDRESS",
    "alchemy_api_key": "YOUR_ALCHEMY_API_KEY",
    "tidbyt": {
        "device_id": "YOUR_DEVICE_ID",
        "api_token": "YOUR_TIDBYT_API_TOKEN",
        "update_interval": 5
    }
}

📁 Project Structure

• new_nft_display.star - Main Tidbyt app code
• update.sh - Display update script
• config.template.json - Configuration template
• .gitignore - Git ignore rules

🔒 Security

This project takes security seriously:

• ✅ Uses config templates to avoid credential exposure
• ✅ Gitignore prevents sensitive file commits
• ✅ Secure API key handling

🛠️ Installation

macOS

# Install Homebrew if needed
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install pixlet
brew install pixlet

Linux (Ubuntu/Debian)

# Follow Tidbyt's pixlet installation guide
# https://tidbyt.dev/docs/build/installing-pixlet

🔍 Troubleshooting

Common issues and solutions:

1. No NFTs displaying:

   • Verify wallet address is correct
   • Check Alchemy API key permissions
   • Ensure wallet has NFTs on Base network

2. Update script errors:

   • Verify Tidbyt API token
   • Check device ID
   • Ensure pixlet is installed correctly
   • Make sure update.sh is executable (chmod +x update.sh)

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Tidbyt team for their amazing platform
• Base blockchain for NFT support
• Alchemy for their robust API

📞 Support

If you're having issues, please:

1. Check the troubleshooting guide
2. Open an issue with detailed information

🔮 Future Plans

• Support for multiple wallets
• Additional display layouts
• Animation options
• NFT metadata filtering
• Support for NFT collections larger than 1000 items