# Asset Library User Guide

Asset Library is a unified content archive that tracks all AI-generated content across all ALwrity modules. This guide covers search, filtering, organization, and bulk operations.

## Overview

Asset Library automatically tracks and organizes all content generated by ALwrity tools, including images, videos, audio, and text. It provides powerful search, filtering, and organization features to help you manage your content efficiently.

### Key Features
- **Unified Archive**: All ALwrity content in one place
- **Advanced Search**: Search by ID, model, keywords, and more
- **Multiple Filters**: Filter by type, module, date, status
- **Favorites**: Mark and organize favorite assets
- **Grid & List Views**: Choose your preferred view
- **Bulk Operations**: Download, delete, or share multiple assets
- **Usage Tracking**: Monitor asset usage and performance

## Getting Started

### Accessing Asset Library

1. Navigate to **Image Studio** from the main dashboard
2. Click on **Asset Library** or go directly to `/image-studio/asset-library`
3. View all your generated content

### Basic Workflow

1. **Browse Assets**: View all your generated content
2. **Search/Filter**: Find specific assets using search and filters
3. **Organize**: Mark favorites, create collections
4. **Download**: Download individual or multiple assets
5. **Manage**: Delete unused assets, track usage

## Search & Filtering

### Search Options

**ID Search**:
- Search by asset ID
- Useful for finding specific assets
- Partial ID matching supported

**Model Search**:
- Search by AI model used
- Find assets generated with specific models
- Example: "ideogram-v3-turbo", "stability-ultra"

**General Search**:
- Search across all asset metadata
- Searches titles, descriptions, prompts
- Keyword-based matching

### Filtering Options

**Type Filter**:
- **All Assets**: Show everything
- **Images**: Image files only
- **Videos**: Video files only
- **Audio**: Audio files only
- **Text**: Text content only
- **Favorites**: Only favorited assets

**Status Filter**:
- **All**: All statuses
- **Completed**: Successfully generated
- **Processing**: Currently being generated
- **Failed**: Generation failed
- **Pending**: Queued for generation

**Date Filter**:
- Filter by creation date
- Select specific date
- Useful for finding recent or old assets

**Module Filter**:
- Filter by source module
- Image Studio, Story Writer, Blog Writer, etc.
- Find assets from specific tools

## Views

### List View

**Features**:
- Detailed table layout
- All metadata visible
- Easy sorting and filtering
- Compact information display

**Best For**:
- Finding specific assets
- Viewing detailed information
- Bulk operations
- Data analysis

### Grid View

**Features**:
- Visual card-based layout
- Image previews
- Quick actions
- Visual browsing

**Best For**:
- Visual content browsing
- Quick asset selection
- Creative workflows
- Portfolio review

## Organization Features

### Favorites

**Marking Favorites**:
1. Click the favorite icon on any asset
2. Asset is added to favorites
3. Filter by "Favorites" to see only favorited assets

**Use Cases**:
- Mark best-performing assets
- Organize campaign assets
- Create quick access lists
- Build content libraries

### Collections (Coming Soon)

Future feature for organizing assets into collections:
- Create custom collections
- Organize by campaign, project, or theme
- Share collections with team
- Collection-based filtering

### Tags (Coming Soon)

Future feature for AI-powered tagging:
- Automatic tagging
- Manual tag addition
- Tag-based search
- Tag filtering

## Bulk Operations

### Bulk Download

**How to Use**:
1. Select multiple assets using checkboxes
2. Click "Download" button
3. All selected assets download

**Use Cases**:
- Download campaign assets
- Export content libraries
- Backup important assets
- Share with team

### Bulk Delete

**How to Use**:
1. Select multiple assets
2. Click "Delete" button
3. Confirm deletion
4. Selected assets are removed

**Use Cases**:
- Clean up unused assets
- Remove failed generations
- Free up storage
- Organize content

### Bulk Share (Coming Soon)

Future feature for sharing multiple assets:
- Share collections
- Generate shareable links
- Team collaboration
- Client sharing

## Asset Information

### Metadata Display

Each asset shows:
- **ID**: Unique asset identifier
- **Model**: AI model used for generation
- **Status**: Generation status
- **Type**: Asset type (image, video, audio, text)
- **Source Module**: Which ALwrity tool created it
- **Created Date**: When asset was generated
- **Cost**: Credits used for generation
- **Dimensions**: Image/video dimensions (if applicable)

### Status Indicators

**Completed**:
- Green checkmark
- Successfully generated
- Ready to use

**Processing**:
- Orange hourglass
- Currently being generated
- Wait for completion

**Failed**:
- Red error icon
- Generation failed
- May need retry

**Pending**:
- Gray icon
- Queued for generation
- Waiting to process

## Usage Tracking

### Download Tracking

- Tracks how many times assets are downloaded
- Useful for identifying popular content
- Helps understand content performance

### Share Tracking

- Tracks how many times assets are shared
- Monitors content distribution
- Useful for analytics

### Usage Analytics (Coming Soon)

Future feature for detailed analytics:
- Usage statistics
- Performance metrics
- Content insights
- Trend analysis

## Integration

### Automatic Tracking

Assets are automatically tracked from:
- **Image Studio**: All generated and edited images
- **Story Writer**: Scene images, audio, videos
- **Blog Writer**: Generated images
- **LinkedIn Writer**: Generated content
- **Other Modules**: All ALwrity tools

### Manual Upload (Coming Soon)

Future feature for manual asset upload:
- Upload external assets
- Organize all content in one place
- Unified content management

## Best Practices

### Organization

1. **Use Favorites**: Mark important assets
2. **Regular Cleanup**: Delete unused assets
3. **Search Effectively**: Use filters to find assets
4. **Track Usage**: Monitor popular content

### Workflow

1. **Generate Content**: Create assets in various modules
2. **Review in Library**: Check all assets in one place
3. **Organize**: Mark favorites, create collections
4. **Download**: Export when needed
5. **Clean Up**: Remove unused assets regularly

### Search Tips

1. **Use Specific Terms**: More specific searches work better
2. **Combine Filters**: Use multiple filters together
3. **Search by Model**: Find assets from specific AI models
4. **Date Ranges**: Use date filter for recent content

## Troubleshooting

### Common Issues

**Assets Not Appearing**:
- Check filters - may be filtering out assets
- Verify generation completed successfully
- Check source module integration
- Refresh the page

**Search Not Working**:
- Try different search terms
- Check spelling
- Use filters instead of search
- Clear search and try again

**Slow Loading**:
- Large asset libraries may load slowly
- Use filters to reduce results
- Check internet connection
- Pagination helps with large lists

**Missing Metadata**:
- Some older assets may have limited metadata
- New assets have complete information
- Check asset creation date

### Getting Help

- Check filtering options if assets are missing
- Review the [Workflow Guide](workflow-guide.md) for common workflows
- See [Implementation Overview](implementation-overview.md) for technical details

## Next Steps

After organizing assets in Asset Library:

1. **Use Assets**: Download and use in your projects
2. **Share**: Share assets with team or clients
3. **Analyze**: Review usage and performance
4. **Create More**: Generate new content in Image Studio modules

---

*For technical details, see the [Implementation Overview](implementation-overview.md). For API usage, see the [API Reference](api-reference.md).*

