Grade Vault is an iOS app designed to help students track and manage their academic progress. This app allows you to record courses, assignments, and calculate your GPA while keeping everything synchronized across your devices using iCloud.
Getting Started
How do I add a new course?
- Tap "Add Course" from the main screen
- Enter the required details:
- Course name
- Credits (typically 1-6)
- Term
- Teacher
- Optional: Enable weighted grades or set custom grade thresholds
How do I set up my first term?
- Tap "Settings" (gear icon)
- Select "Academic Terms"
- Tap "Add Term"
- Enter term details:
- Name (e.g., "Fall 2024")
- Type (Semester, Quarter, or Trimester)
- Start and End dates
- Institution name (optional)
- Status (Current, Upcoming, or Completed)
Managing Assignments
How do I add assignments to a course?
- There are two ways:
- Tap "Add Grade" in the top toolbar, or
- Open a course and tap "Add Assignment"
- Then enter:
- Assignment name
- Earned points
- Total points (defaults to 100)
- Due date (optional)
How do I handle weighted grades?
- Enable weighted grades when creating the course
- Set each assignment's weight percentage
- Ensure total weights don't exceed 100%
How do I add extra credit?
- Create a new assignment
- Name it "Extra Credit" or similar
- Set earned points to the extra credit value (e.g., 5)
- Set total points to 1
Key Terms
- Academic Term: A period of study such as a semester, quarter, or trimester. Each term can contain multiple courses and has specific start and end dates.
- Course/Class: An individual subject or class taken during a term. Each course has its own assignments, grade calculations, and credit value that contributes to your GPA.
- Grade: A measure of academic performance, typically expressed as a letter (A, B, C, etc.) and percentage. Grades are calculated from assignment scores and can be weighted differently based on course settings.
- GPA (Grade Point Average): A numerical representation of academic performance, typically on a 4.0 scale. GPA is calculated by converting letter grades to grade points and weighing them by course credits.
- Credits: A numerical value assigned to courses indicating their weight in GPA calculations and typically reflecting the hours of instruction per week. More credits mean the course has more impact on your GPA.
Grade Calculations
Default Grade Formula:
- (sum of earned points) / (sum of total points) × 100
- Example: If you earned 85 points out of 100 total points, your grade would be 85%.
Weighted Grade Formula:
- sum((assignment weight × earned points) / (total points))
- Example: For a quiz worth 20% where you earned 18/20 points, it contributes (20 × 18/20) = 18 percentage points to your final grade.
Weighted Grade Options:
- Use Only Graded: Calculates weighted grades using only graded assignments, redistributing weights proportionally.
- Include Ungraded: Treats ungraded assignments as 0 points earned while maintaining their assigned weights.
GPA Calculations
Term GPA:
- (sum of (course grade points × credits)) / (sum of credits)
- Example: An A (4.0) in a 3-credit course and a B (3.0) in a 4-credit course gives: (4.0 × 3 + 3.0 × 4) / (3 + 4) = 3.43 GPA.
Grade Points:
- A/A+ = 4.0, A- = 3.7
- B+ = 3.3, B = 3.0, B- = 2.7
- C+ = 2.3, C = 2.0, C- = 1.7
- D+ = 1.3, D = 1.0, D- = 0.7
- F = 0.0
Can I customize the grade scale?
- Yes, go to Settings
- Select "Grade Scale"
- Adjust minimum percentages for each grade
- Changes apply to all courses
What's the difference between Term GPA and Cumulative GPA?
- Term GPA:
- Only includes courses in the current term
- Shows performance for specific semester/quarter
- Resets each term
- Cumulative GPA:
- Includes all courses across all terms
- Shows overall academic performance
- Updates as new grades are added
Data Management
How do I sync my data across devices?
- Open your device's Settings
- Tap your Apple ID
- Select iCloud
- Enable Grade Vault sync
- All data will automatically sync to devices using your Apple ID
How do I export my grades?
- Open the course you want to export
- Tap the share icon
- Select "Export to PDF"
- The PDF includes:
- Course and term information
- All assignments and grades
- Final grade calculation
- Grade distribution chart
How do I delete items?
- Courses: Swipe left on the course in the main list
- Assignments: Swipe left on the assignment in the course view
- Terms: Go to Settings → Academic Terms → Swipe left on term
Advanced Features
How can I analyze my potential grades?
- Open a course
- Go to "Grade Analysis"
- Enter estimated points for remaining work
- View calculations for:
- Possible final grades
- Required scores on remaining work
- Minimum scores needed for each letter grade
Troubleshooting
Why isn't my data syncing?
- Check your iCloud connection
- Verify internet connectivity
- Check sync status in About view
Why aren't my grades updating correctly?
- Verify all assignment points are entered correctly
- Check if course uses weighted grades
- Ensure total weights don't exceed 100%
Subnet Vault is an iOS app designed to help network administrators and IT professionals with subnet calculations, network diagnostics, and remote device management.
Basic Subnet Calculations
How do I perform a standard subnet calculation?
- Enter a base IP address and CIDR notation (e.g., 192.168.0.0/24)
- Tap Calculate to view results, which include:
- Network address
- Broadcast address
- Usable IP range
- Number of available hosts
What is VLSM and how do I use it?
Variable Length Subnet Mask (VLSM) allows you to create subnets of different sizes from a single network address. To use the VLSM Calculator:
- Enter your base network address
- Add the required number of hosts for each subnet
- The app will calculate the optimal subnet sizes automatically
Does the app support IPv6?
Yes, for IPv6 calculations, switch to the IPv6 Calculator tab where you'll find specialized tools for IPv6 subnetting and address management.
Network Tools
How do I test if a host is reachable?
- Use the Ping tool
- Enter an IP address or hostname
- View results showing round-trip times and packet loss
How can I look up domain information?
- Use the WHOIS tool
- Enter a domain name
- View registration details, ownership, and expiration information
What DNS records can I look up?
- Enter any domain name
- Select from available record types:
- A records (IPv4)
- AAAA records (IPv6)
- MX records (mail)
- TXT records
- CNAME records
- Other DNS record types
Wake-on-LAN Feature
How do I wake up a remote device?
- Go to the Wake-on-LAN tab
- Enter the device's MAC address
- Enter the network broadcast address (or use auto-detect)
- Optionally specify a custom port (default is 9)
- Tap "Wake Device" to send the magic packet
Why isn't Wake-on-LAN working?
Check these common issues:
- Verify the target device supports Wake-on-LAN
- Ensure Wake-on-LAN is enabled in the device's BIOS/settings
- Confirm the device is in sleep mode (not powered off)
- Double-check the MAC address and broadcast address
- Verify you're on the same network as the target device
Sharing and Exporting
How can I share calculation results?
- Tap the share icon after performing calculations
- Choose from sharing options:
- Messages
- AirDrop
- Save to Files
Can I quickly copy specific values?
- Tap the copy icon next to any individual result
- The value will be copied in a clean, formatted text layout
Deviant Weather is an iOS app that provides detailed weather information with a unique focus on historical weather patterns and temperature deviations. The app offers comprehensive weather data through Apple Weather and historical data from NOAA.
Basic Usage
How do I add locations to the app?
- Tap the "+" button in the top toolbar
- Enter a city name or address
- Select the desired location from search results
- You can add up to 6 locations total
How do I manage my saved locations?
- Swipe left on a location to delete
- Tap a location to view detailed weather
- Favorite locations appear at the top of the list
Understanding Temperature Deviance
What is temperature deviance?
Temperature deviance shows how much the current temperature differs from the historical normal for that location, date, and time. A positive deviance (shown in red) means it's warmer than normal, while a negative deviance (shown in blue) means it's cooler than normal. The intensity of the color indicates how significant the difference is.
How is deviance calculated?
The app compares the current temperature to historical normals from NOAA's climate database. For example, if it's currently 75°F and the historical normal is 70°F, the deviance would be +5°F (warmer). The color intensity changes at specific thresholds:
- Light (0-5°)
- Medium (5-10°)
- Strong (>10°)
Weather Data
Where does the weather data come from?
- Current weather: Apple WeatherKit for real-time updates and local forecasts
- Historical data: NOAA (National Oceanic and Atmospheric Administration)
What time period do the historical normals cover?
The historical normals are based on NOAA's U.S. Climate Normals from 1981-2010. These are 30-year averages including daily temperature normals, monthly averages, and hourly normals for temperature, precipitation, and other weather conditions.
How often is the data updated?
- Current conditions: Every 5 minutes
- Historical normals: Daily updates
- Monthly climate data: Weekly refresh
Features and Display
What do the different chart colors mean?
- Red: Temperatures above historical normals
- Blue: Temperatures below historical normals
- Gray (dashed): Historical normal line
Can I get weather alerts?
Yes, the app displays official National Weather Service alerts for your saved locations. Alerts are color-coded by severity:
- Red: Severe warnings
- Orange: Warnings
- Yellow: Watches
- Blue: Advisories
Settings and Preferences
What unit options are available?
- Temperature: Celsius/Fahrenheit
- Wind Speed: km/h or mph
- Pressure: mb or inHg
- Visibility: km or mi
Troubleshooting
What should I do if weather data won't load?
- Check your internet connection
- Ensure Location Services are enabled
- Pull down to manually refresh
- The app will use cached data as a fallback until fresh data can be loaded
How is my privacy protected?
- Location data is used only for weather forecasts
- No data is shared with third parties
- Locations can be entered manually instead of using GPS
- All settings and favorites are stored locally on your device
Econ Core is an iOS app that provides insights into key economic indicators, allowing users to track, analyze, and customize the data they care about most. The app offers comprehensive economic data tracking and analysis tools.
Basic Usage
How do I search for economic indicators?
- Use the Search Bar at the top of the main screen
- Enter keywords related to:
- Indicator name
- Description
- Source
- Results filter dynamically as you type
- Clear search by tapping the 'x' icon
How do I customize my indicators?
- Tap the Edit button in the top-right corner
- Toggle indicators on/off using the switches
- Drag and drop items to reorder the list
- Changes save automatically
Viewing Data
How do I view detailed information about an indicator?
- Tap any indicator in the list
- View detailed information including:
- Current values
- Historical trends
- Source information
Why does some data show as "Loading..."?
- This appears when the app is fetching new data
- Ensure you have an active internet connection
- The app will use cached data when offline
- Pull to refresh for the latest updates
Settings and Preferences
How do I provide feedback?
- Open Settings
- Select Contact Us button
- Submit your feedback or questions via the form
Data Updates
How often is the data updated?
- The app refreshes data automatically when:
- Indicators are updated at their source
- You manually refresh the data
- Internet connection required for updates
Fur File is an iOS app designed to help pet owners track and manage their pets' health, activities, and care records. The app allows you to record events, schedule reminders, store attachments, and keep everything synchronized across your devices using iCloud.
Getting Started
How do I add my first pet?
- Tap "Add Pet" from the main Pets screen
- Enter required details: pet name, species, breed (optional), birth date, weight and gender
- Optional: Add a photo or choose from 100+ SF Symbol icons across 10 categories
- Tap "Save" to create your pet's profile
How do I set up iCloud sync?
- Go to Settings > Sync & Data
- Ensure you're signed into iCloud on your device
- Toggle "CloudKit Sync" to enable synchronization
- Your pet data will automatically sync across all devices
What's the difference between Events and Reminders?
- Events: Past activities that have occurred (vet visits, medications given)
- Reminders: Future scheduled tasks you need to remember (upcoming appointments)
Managing Pet Records
How do I log a vet visit?
- Navigate to your pet's profile and tap "Add Event"
- Select event type "Veterinary"
- Enter title, date/time, notes, and cost (optional)
- Add attachments like photos or documents if needed
How do I track medications?
- Past doses: Create an Event with type "Medication"
- Future doses: Create a Reminder with repeat schedule
- Include medication name, dosage, administration time, and vet instructions
How do I add photos and documents?
- In Events, scroll to "Attachments" section
- Tap "Add Photos" or "Add Documents"
- Attachments are automatically backed up to iCloud
Reminders and Notifications
How do I set up medication reminders?
- Tap "Add Reminder" from the Reminders tab
- Enter title, associated pet, date/time, and repeat schedule
- Enable notifications in Settings > Notifications
What repeat options are available?
- Never, Daily, Weekly, Monthly, or Yearly
- Perfect for medications, vaccinations, and regular checkups
How do I manage notification permissions?
- Go to Settings > Notifications
- Tap "Request Permission" if needed
- Use "Send Test Notification" to verify functionality
Data Management
How do I export my pet data?
- Go to Settings > Sync & Data > Export Data
- Choose JSON format and select save location
- Export includes all pets, events, reminders, and attachment metadata
How do I backup my data?
- Enable iCloud sync for automatic cloud backup
- Use export feature for additional local backups
How do I delete all my data?
- Go to Settings > Sync & Data > Delete All Data
- Warning: This action cannot be undone
Search and Organization
How do I search for information?
- Use the Search tab to find information across all pets
- Search by pet names, event titles, reminder titles, dates, and keywords
- Use filters to narrow results by pet, date range, or content type
How do I organize events?
- Events are automatically categorized by type
- Sort by date, type, or cost in pet profiles
- View all events across pets using the Search tab
Settings and Customization
How do I change units?
- Go to Settings to choose preferred weight unit, temperature unit, and currency
- Units update immediately throughout the app
How do I view diagnostic information?
- Go to Settings > Diagnostics > View Diagnostics
- See storage usage, sync status, performance metrics, and error logs
Troubleshooting
My attachments aren't syncing
- Ensure iCloud sync is enabled on all devices
- Check iCloud storage space and internet connectivity
- Large files may take time to upload/download
I'm not receiving notifications
- Check notification permissions in device Settings
- Verify reminders have future dates set
- Ensure "Do Not Disturb" isn't blocking notifications
My data isn't syncing
- Confirm same iCloud account on all devices
- Check internet connectivity
- Try toggling iCloud sync off and on
The app is running slowly
- Check device storage space
- Clear cache in Settings > Performance
- Restart the app if issues persist
Privacy and Security
What data does Fur File collect?
- All pet data is stored locally and in your private iCloud account
- No personal information is shared with third parties
Is my data secure?
- All data is encrypted in transit and at rest
- iCloud sync uses Apple's enterprise-grade security
- You maintain complete control over your information
Can I use Fur File offline?
- Yes, all core features work offline
- Data syncs when internet connection is restored
Advanced Features
How do I add veterinary contacts?
- Edit your pet's profile and scroll to "Veterinary Contacts"
- Add vet name, clinic, phone, email, and address
- Mark primary vet for quick access
Can I track multiple pets?
- Yes, add unlimited pets with individual profiles
- Each pet has separate events and reminders
- Use search to find information across all pets
How do I track pet weight?
- Add weight measurements as Health Events
- Include weight value and date for history tracking
- Use consistent units set in Settings
Vehicle Pro is an all-in-one iOS app for tracking maintenance, repairs, ownership records, and key details for all your vehicles and equipment. Whether you're managing cars, motorcycles, tractors, or chainsaws, Vehicle Pro helps you stay organized and in control.
Basic Usage
How do I add my first vehicle?
- Tap "Add" button in the top-right corner
- Select "Add Vehicle" from the menu
- Enter required details:
- Make and model
- Year
- Vehicle type
- Additional notes (optional)
- Tap "Save" to add the vehicle
Can I add equipment like lawnmowers or chainsaws?
- Yes! When adding a new record:
- Choose "Small Engine Equipment" category
- Select specific equipment type
- Enter equipment details
- Add maintenance schedule (optional)
Maintenance and Repairs
How do I log a maintenance event?
- Select vehicle from your list
- Tap "Add Event" button
- Choose "Maintenance" type
- Enter event details:
- Date performed
- Mileage/hours
- Service type
- Cost (optional)
- Notes (optional)
How do I track repairs?
- Select vehicle from list
- Tap "Add Event"
- Choose "Repair" type
- Enter repair details:
- Repair description
- Date completed
- Cost
- Service provider
Documentation
How do I record ownership changes?
- Select vehicle from list
- Tap "Add Ownership Record"
- Choose record type:
- Purchase
- Sale
- Transfer
- And others
- Enter transaction details
Can I store documents and photos?
- Yes! In vehicle details:
- Tap "Attachments"
- Tap "Add File"
- Choose photo or document
- Files sync via iCloud
Organization
How do I search for vehicles or events?
- Use Search Bar at top of screen
- Search by:
- Make/model
- Year
- Event type
- Description
How do I organize my vehicles?
- Use toolbar options to:
- Sort by make, year, or last updated
- Group by category or type
- Filter by status
Data Management
Is my data backed up?
- Yes, Vehicle Pro uses iCloud, if enabled, to:
- Sync across devices
- Back up all records
- Store documents securely
How do I reset the app?
- To reset all data:
- Open Settings
- Tap "Delete All Records"
- Confirm deletion
SkySort is an iOS app designed to help you identify and catalog cloud types using on-device machine learning. The app allows you to capture or import cloud photos, classify them with confidence scores, and build a personal archive of observations with weather data and location information—all synchronized across your devices using iCloud.
Getting Started
How do I identify my first cloud?
- Tap "Take Photo" from the home screen to capture a cloud image with your camera, or
- Tap "Photos" to select an existing image from your photo library, or
- Tap "Files" to import an image from your device storage
- The app will automatically classify the cloud type and show you the results with a confidence score
- Review the top 3 predictions
- Tap "Save" to add it to your observation history
What cloud types can the app identify?
SkySort can identify 12 different cloud types:
- Cumulus - Fair weather clouds with puffy, cotton-like appearance
- Altocumulus - Mid-level patches or layers
- Cirrus - High, wispy, ice crystal clouds
- Stratocumulus - Low, lumpy cloud layers
- Cirrocumulus - High, rippled clouds (mackerel sky)
- Cumulonimbus - Towering storm clouds
- Contrail - Aircraft condensation trails
- Stratus - Low, uniform gray layers
- Nimbostratus - Dark, rain-producing clouds
- Altostratus - Mid-level gray sheets
- Cirrostratus - High, thin sheets that create halos
- Clear Sky - No clouds present
What does the confidence score mean?
The confidence score (shown as a percentage) indicates how certain the machine learning model is about the classification. Higher percentages mean the model is more confident in its prediction. The app uses a default threshold of 65%—classifications below this threshold are marked as "Uncertain" but can still be saved.
Capturing and Importing
Can I import photos I've already taken?
Yes! You can import cloud photos from:
- Photos Library: Select images from your photo library. The app will extract location data from the photo's EXIF metadata if available.
- Files: Import JPEG, HEIC, or PNG images from iCloud Drive or other file storage locations.
What image formats are supported?
SkySort supports JPEG (.jpg, .jpeg), HEIC (.heic, .heif), and PNG (.png) formats. Images must be a maximum file size of 30 MB, minimum dimension of 1024 pixels on the shortest side, and maximum dimension of 12,000 pixels.
Does the app save location data with my observations?
Yes, if you enable location services. Camera captures automatically save your current GPS location, photo imports extract location from EXIF data if available, and files imports can optionally use your current location. You can disable location saving entirely in Settings.
Understanding Classifications
What if the confidence is below the threshold?
If the top prediction is below your confidence threshold (default 65%), the app will mark the result as "Uncertain", still show you the top 3 predictions, allow you to save the observation as "Unknown" or manually select one of the predicted cloud types, and display a warning indicator. You can adjust the confidence threshold in Settings (range: 50%-90%).
Can I see multiple predictions?
Yes! Every classification shows the top 3 predictions with their confidence scores, even if only the top prediction meets your threshold. This helps you understand what the model detected and learn about similar cloud types.
Weather Data
Does the app capture weather conditions?
Yes! When you take a photo with the camera and have location enabled, SkySort automatically fetches current weather conditions from Apple Weather, including temperature, atmospheric pressure, humidity, wind speed and direction, cloud cover percentage, visibility, UV index, and weather condition.
Why doesn't my imported photo have weather data?
Weather data is only captured for photos taken with the in-app camera at the time of capture. Photos imported from your library or files cannot have weather data added retroactively because the app doesn't know the exact time and conditions when the photo was originally taken.
Can I choose between Celsius and Fahrenheit?
Yes! Go to Settings → Units and select either Metric (Celsius, meters, hPa, m/s, km) or Imperial (Fahrenheit, feet, inHg, mph, miles). All data is stored in metric units internally—the unit preference only affects how data is displayed.
Managing Observations
How do I view my observation history?
- Tap the "History" button in the top toolbar, or
- Switch to the "Stats" tab and tap "View All"
- Your observations are listed with thumbnails, cloud type, date, and confidence scores
Can I add notes to my observations?
Yes! When saving an observation, you can add notes (up to 1,000 characters), add custom tags for organization, describe weather conditions you observed, and note any special features like mammatus formations or virga.
Can I search my observations?
Yes! In the History view, use the search bar to find observations by cloud type, notes, or tags. Apply filters for date range, cloud type, confidence level, and location. Sort by date, confidence, or cloud type.
iCloud Sync
How does iCloud sync work?
When enabled, SkySort automatically syncs your observations across all your devices signed in with the same Apple ID. Observations sync via iCloud, images are uploaded to your private iCloud storage, changes made on one device appear on all devices, and deletions are propagated across devices.
What happens if I'm offline?
SkySort works offline! You can capture and classify clouds (ML runs on-device), save observations locally, and view your existing observations. When you reconnect, observations will automatically sync to iCloud.
Data Export
Can I export my observation data?
Yes! SkySort offers two export formats: CSV (spreadsheet format with all observation data) and PDF (formatted report with images and details). To export, open History, tap the menu (•••) button, select "Export CSV" or "Export PDF", choose your export options, and share via the system share sheet.
What export options are available?
When exporting, you can choose to include/exclude location data (redact GPS coordinates for privacy), include/exclude weather data, include/exclude notes, and include/exclude technical data like model version and device info.
Learning About Clouds
What is the Learn tab?
The Learn tab contains educational content including a Cloud Encyclopedia with detailed profiles of all 12 cloud types (scientific names, altitude ranges, formation processes, weather indicators, visual characteristics, and fun facts), a Glossary of meteorological terms and definitions, and Search functionality to find specific cloud types or terms quickly.
What do the altitude categories mean?
Clouds are grouped by altitude: High Clouds (above 20,000 ft) include Cirrus, Cirrocumulus, and Cirrostratus. Middle Clouds (6,500-20,000 ft) include Altocumulus and Altostratus. Low Clouds (below 6,500 ft) include Cumulus, Stratocumulus, Stratus, and Nimbostratus. Cumulonimbus has Vertical Development and can span all altitudes. Special categories include Contrails and Clear Sky.
Statistics
What statistics does the app track?
The Stats tab shows total observations, most common cloud type, average confidence, distribution chart breakdown by cloud type, and 30-day activity with daily observation counts for the last month.
How is observation quality determined?
Each observation is assigned a quality indicator based on confidence: Excellent (90-100%), Good (75-89%), Fair (65-74%), or Uncertain (<65%).
Troubleshooting
Why won't the camera work?
- Ensure you've granted Camera permission in iOS Settings → SkySort → Camera
- Restart the app
- Check that your device's camera is functioning properly
- Try importing a photo from your library instead
Why is location data missing?
Location may be missing if Location Services are disabled for SkySort, you denied location permission, GPS signal was unavailable at capture time, the imported photo has no EXIF location data, or "Save Location" is disabled in Settings. Enable location: iOS Settings → SkySort → Location → While Using the App.
Observations aren't syncing across devices
Check that iCloud Sync is enabled in Settings on all devices, you're signed in to the same Apple ID on all devices, you have an active internet connection, you have available iCloud storage space, and iCloud Drive is enabled in iOS Settings → [Your Name] → iCloud.
Privacy and Security
What data does the app collect?
SkySort is privacy-first. The app only collects photos you explicitly capture or import, location data only if you grant permission and enable it, weather data only for camera captures with location, no analytics or usage tracking, and no data shared with third parties.
Is my data private?
Yes! All data is processed on-device (ML classification runs entirely on your iPhone/iPad), stored locally in your device's secure storage, synced privately using your private iCloud storage, not uploaded to external servers, and user-controlled (you choose what to save, export, and share).
Can I use the app without iCloud?
Yes! iCloud sync is completely optional. Disable "iCloud Sync" in Settings and all observations remain local to your device. You can still export data manually and no Apple ID is required for core functionality.
Technical Information
What iOS version is required?
iOS 17.0 or later. Compatible with iPhone and iPad. Optimized for modern devices (A12 chip or newer recommended).
Does the app work offline?
Yes! Core features work offline including capturing photos, classifying clouds (ML runs on-device), saving observations locally, viewing existing observations, and browsing educational content. Fetching weather data and syncing to iCloud require internet.
ArticleQ is an iOS and macOS app designed to help you save, organize, and read articles from across the web. The app allows you to capture articles with a single tap, subscribe to RSS feeds, listen to articles with text-to-speech, and keep everything synchronized across your devices using iCloud.
Getting Started
How do I add articles to my reading queue?
There are several ways to add articles:
- Safari Share Extension: While browsing in Safari, tap the Share button and select "Add to ArticleQ"
- Add Article Sheet: Tap the "+" button in the Queue tab and paste a URL
- RSS Feeds: Subscribe to feeds and articles are automatically added
How do I set up the Safari Share Extension?
- Open Safari and navigate to any article
- Tap the Share button
- Scroll down and tap "Edit Actions"
- Find "ArticleQ" and toggle it on
- Optionally, tap and drag to reorder it higher in the list
What's the difference between Queue and Feeds?
- Queue: Your personal reading list of saved articles from any source. Articles are parsed for clean, distraction-free reading.
- Feeds: RSS/Atom feed subscriptions that automatically fetch new content from your favorite websites.
Managing Articles
How do I organize my reading queue?
- Archive: Swipe left on an article to archive it (removes from inbox but keeps it saved)
- Favorite: Swipe right to mark articles as favorites for quick access
- Tags: Add custom tags to categorize articles by topic
- Filters: Use the filter menu to view Inbox, Archived, Favorites, or Unread articles
How do I mark articles as read or unread?
- Swipe right on an article and tap "Mark Read" or "Mark Unread"
- In the article view, tap the "Mark Read/Unread" button in the action bar
- Articles are automatically marked as read when you open them
Can I delete articles permanently?
- Swipe left on an article and tap "Delete"
- In the article view, tap the Delete button (trash icon)
- Warning: Deleted articles cannot be recovered
Reading Experience
How do I customize the reader appearance?
Go to Settings → Reader to adjust:
- Font family (System, New York, Georgia, Palatino, and more)
- Font size (12-24 points)
- Line spacing
- Margins
- Text justification
- Reader theme (Light, Sepia, Dark, or Auto)
What is Text-to-Speech and how do I use it?
ArticleQ can read articles aloud using high-quality voices:
- Open an article and tap the "Play" button in the action bar
- Control playback with play/pause, skip forward/backward
- Adjust voice and speed in Settings → Text-to-Speech
- Premium voices require downloading in iOS Settings → Accessibility → Spoken Content
How do I create highlights?
- While reading, select text by long-pressing and dragging
- Tap "Highlight" in the popup menu
- View all highlights by tapping "Highlights" in the action bar
- Export highlights in Markdown or plain text format
RSS Feeds
How do I subscribe to an RSS feed?
- Go to the Feeds tab and tap "Add Feed"
- Enter the website URL or RSS feed URL
- The app will auto-discover the feed if you enter a website URL
- Tap "Subscribe" to add the feed
How do I organize feeds into lists?
- Create a new list by tapping "New List" in the Feeds sidebar
- Add feeds to lists by selecting a feed and choosing "Add to List"
- Lists can have custom names, icons, and colors
How often are feeds refreshed?
- Automatic refresh interval can be set in Settings → Feeds (1, 2, 4, 12, or 24 hours)
- Enable "Refresh on App Launch" for immediate updates when opening the app
- Pull down on the feed list to manually refresh all feeds
AI Features
What is AI Summary?
ArticleQ can generate concise summaries of articles using on-device AI:
- Open an article and tap "Summary" in the action bar
- Tap "Generate Summary" to create a summary
- Summaries are saved and available offline
- Requires a device with Apple Neural Engine
How does Semantic Search work?
Semantic search finds articles based on meaning, not just keywords:
- Go to the Search tab and select "Semantic Search"
- Enter a natural language query (e.g., "articles about climate change")
- The app finds conceptually related articles even if they don't contain your exact words
- Requires generating embeddings for your articles (done automatically)
iCloud Sync
How do I enable iCloud sync?
- Go to Settings → iCloud & Data
- Ensure you're signed into iCloud on your device
- iCloud sync is enabled by default
- Your articles, feeds, highlights, and tags sync across all your devices
What data is synced across devices?
- Articles and their content
- RSS feed subscriptions
- Highlights and annotations
- Tags and organization
- Reading progress and scroll position
- App settings and preferences
What happens if I'm offline?
ArticleQ works fully offline:
- Read any previously saved articles
- Create highlights and notes
- Browse your feed items
- Changes sync automatically when you reconnect
Data Management
How do I export my data?
- Go to Settings → Storage & Data → Export
- Choose export format (JSON)
- Select what to include (articles, feeds, highlights, tags)
- Save to Files or share via AirDrop, Mail, etc.
How do I manage storage?
- Go to Settings → Storage & Data
- View storage usage breakdown
- Clear cached images and thumbnails
- Delete old archived articles
- Remove unused feed items
How do I delete all my data?
- Go to Settings → Storage & Data → Delete All Data
- This removes all articles, feeds, highlights, and settings
- Warning: This action cannot be undone
Troubleshooting
Why won't an article parse correctly?
Some articles may not parse well due to:
- Paywall protection (the app will show a notice if detected)
- JavaScript-heavy websites
- Non-standard HTML structure
- Try opening the article in Safari using the "Safari" button
Why aren't my feeds updating?
Check these common issues:
- Verify you have an internet connection
- Check if the feed URL is still valid
- Some feeds update infrequently by design
- Try removing and re-adding the feed
UnitLens is an iOS app designed to help you make informed food choices by scanning product barcodes for instant nutrition information, allergen alerts, and food quality scores. The app uses data from Open Food Facts, the world's largest open food database, and keeps your favorites synchronized across devices using iCloud.
Getting Started
How do I scan my first product?
- Open the app and tap the "Scan" tab
- Point your camera at a product barcode
- The app will automatically detect and scan the barcode
- View detailed nutrition information instantly
Can I enter a barcode manually?
- Yes! Tap "Enter Barcode Manually" below the scanner
- Type the barcode number (found under the barcode on the product)
- Tap "Search" to look up the product
How do I set up my allergen profile?
- Go to Settings
- Tap "Manage Allergens"
- Select from common allergens (Milk, Eggs, Fish, Shellfish, Tree nuts, Peanuts, Wheat, Soybeans, Sesame) or add custom allergens
- The app will automatically alert you when scanned products contain your allergens
How do I enable iCloud sync?
- Go to Settings
- Toggle "Enable iCloud Sync"
- Ensure you're signed into iCloud on your device
- Your favorites will automatically sync across all devices
- Note: A restart is required for sync changes to take effect
Scanning Products
What types of barcodes does UnitLens support?
- EAN-13 (most common for food products)
- EAN-8 (smaller packages)
- UPC-A (common in North America)
- ITF-14 (shipping containers)
Can I scan from my photo library?
- Yes! Tap the photo icon in the scanner view
- Select an image containing a barcode
- The app will detect and scan the barcode from the image
Why wasn't my product found?
- The product may not be in the Open Food Facts database yet
- Try entering the barcode manually to double-check
- You can contribute the missing product to help others (see Contributing section)
Understanding Nutrition Data
What is Nutri-Score?
Nutri-Score is a nutrition label that rates food quality from A (best) to E (worst):
- A (Green): Excellent nutritional quality
- B (Light Green): Good nutritional quality
- C (Yellow): Average nutritional quality
- D (Orange): Poor nutritional quality
- E (Red): Very poor nutritional quality
What is NOVA classification?
NOVA classifies foods by their level of processing:
- Group 1: Unprocessed or minimally processed foods
- Group 2: Processed culinary ingredients
- Group 3: Processed foods
- Group 4: Ultra-processed foods
What's the difference between "per 100g" and "per serving"?
- Per 100g: Standardized values for easy comparison between products
- Per serving: Values based on the manufacturer's suggested serving size
Why is some nutrition data missing?
- Not all products have complete nutrition information in the database
- Contributors add data over time
- You can help by contributing missing information
Allergen Alerts
How do allergen alerts work?
- Set your allergens in Settings > Manage Allergens
- When you scan a product containing your allergens, you'll see a warning
- The specific allergens found are highlighted in the product details
What allergens can I track?
- Milk
- Eggs
- Fish
- Shellfish
- Tree nuts
- Peanuts
- Wheat
- Soybeans
- Sesame
- Custom allergens you add
Are allergen alerts 100% accurate?
- Allergen data comes from Open Food Facts contributors
- Always verify allergen information on the actual product label
- Use alerts as a helpful guide, not a substitute for reading labels
Favorites
How do I save a product to favorites?
- View any product's details
- Tap the heart icon in the toolbar
- The product is now saved to your Favorites
How do I remove a product from favorites?
- Go to the Favorites tab
- Swipe left on the product you want to remove
- Tap to confirm removal
Comparing Products
How do I compare products side-by-side?
- Open the Compare view (available on iPad)
- Search or add products to compare (up to 6)
- View nutrition values in a side-by-side grid
What metrics are compared?
- Energy (kcal)
- Fat and Saturated Fat
- Carbohydrates and Sugars
- Fiber
- Protein
- Salt and Sodium
Dietary Preferences
What dietary preferences can I set?
Go to Settings to configure:
- Vegetarian
- Vegan
- Gluten-Free
- Keto
- Preferred units (Metric or Imperial)
Troubleshooting
The camera won't start
- Check that UnitLens has camera permission in your device Settings > Privacy > Camera
- Restart the app if the camera appears frozen
- Ensure no other app is using the camera
My favorites aren't syncing
- Confirm iCloud sync is enabled in Settings
- Verify you're signed into the same iCloud account on all devices
- Check your internet connection
- Restart the app after enabling sync
Barcode won't scan
- Ensure adequate lighting on the barcode
- Hold the camera steady about 6 inches from the barcode
- Try the flashlight button for low-light conditions
- If damaged, enter the barcode manually
Privacy and Security
What data does UnitLens collect?
- All personal data (favorites, allergen settings) is stored locally and in your private iCloud account
- No personal information is shared with third parties
Is my data secure?
- All iCloud data is encrypted using Apple's enterprise-grade security
- No account or login required
- You maintain complete control over your information
Can I use UnitLens offline?
- Yes, core features work offline
- Previously viewed products are cached
- New scans require internet to fetch product data
- Contributions queue offline and sync when connected
Data Sources
Where does the nutrition data come from?
- Open Food Facts, a free and open database with over 3 million products
- Data is contributed by users worldwide
- Licensed under the Open Database License (ODbL)
How accurate is the data?
- Data quality varies by product and contributor
- Popular products typically have verified, accurate data
- Always cross-reference with actual product labels for critical decisions